Add includesOwnedAudienceGroups Parameter to Audience API (#1602)

line/line-openapi#105

# Enhancement to Shared Audiences API

This PR introduces a new query parameter `includesOwnedAudienceGroups`
to the `/v2/bot/audienceGroup/shared/list` endpoint in the Business
Manager API. This enhancement allows users to specify whether to include
audience groups owned by the user in the response.

## Changes Made
- Added the `includesOwnedAudienceGroups` parameter to the API endpoint.
  - **Type**: Boolean
  - **Default**: false
  - **Description**: 
- `true`: Include audience groups owned by the LINE Official Account
Manager.
- `false`: Respond only with audience groups shared by Business Manager.
- Removed the `/v2/bot/audienceGroup/{audienceGroupId}/activate` and
`/v2/bot/audienceGroup/authorityLevel` endpoints.

## Purpose
This update provides more flexibility in retrieving audience groups by
allowing users to filter based on ownership. It is especially useful for
users who manage both shared and owned audience groups. The removal of
certain endpoints is part of a cleanup effort to streamline the API.

Please review the changes and let me know if there are any questions or
further modifications needed.

## Documents and Reference
- [Get List of Shared
Audiences](https://developers.line.biz/en/reference/messaging-api/#get-shared-audience-list)
- [Removed
Endpoints](https://developers.line.biz/en/news/2025/03/26/cross-targeting-closing/)

For more information, please refer to the links provided above.

Co-authored-by: github-actions <[email protected]>

Author: github-actions[bot]

clients/line-bot-manage-audience-client/.openapi-generator/FILES

@@ -4,7 +4,6 @@ src/main/java/com/linecorp/bot/audience/model/Adaccount.java
 src/main/java/com/linecorp/bot/audience/model/AddAudienceToAudienceGroupRequest.java
 src/main/java/com/linecorp/bot/audience/model/Audience.java
 src/main/java/com/linecorp/bot/audience/model/AudienceGroup.java
-src/main/java/com/linecorp/bot/audience/model/AudienceGroupAuthorityLevel.java
 src/main/java/com/linecorp/bot/audience/model/AudienceGroupCreateRoute.java
 src/main/java/com/linecorp/bot/audience/model/AudienceGroupFailedType.java
 src/main/java/com/linecorp/bot/audience/model/AudienceGroupJob.java
@@ -24,9 +23,7 @@ src/main/java/com/linecorp/bot/audience/model/DetailedOwner.java
 src/main/java/com/linecorp/bot/audience/model/ErrorDetail.java
 src/main/java/com/linecorp/bot/audience/model/ErrorResponse.java
 src/main/java/com/linecorp/bot/audience/model/GetAudienceDataResponse.java
-src/main/java/com/linecorp/bot/audience/model/GetAudienceGroupAuthorityLevelResponse.java
 src/main/java/com/linecorp/bot/audience/model/GetAudienceGroupsResponse.java
 src/main/java/com/linecorp/bot/audience/model/GetSharedAudienceDataResponse.java
 src/main/java/com/linecorp/bot/audience/model/GetSharedAudienceGroupsResponse.java
-src/main/java/com/linecorp/bot/audience/model/UpdateAudienceGroupAuthorityLevelRequest.java
 src/main/java/com/linecorp/bot/audience/model/UpdateAudienceGroupDescriptionRequest.java

clients/line-bot-manage-audience-client/src/main/java/com/linecorp/bot/audience/client/ManageAudienceClient.java

@@ -30,11 +30,9 @@
 import com.linecorp.bot.audience.model.CreateImpBasedAudienceGroupRequest;
 import com.linecorp.bot.audience.model.CreateImpBasedAudienceGroupResponse;
 import com.linecorp.bot.audience.model.GetAudienceDataResponse;
-import com.linecorp.bot.audience.model.GetAudienceGroupAuthorityLevelResponse;
 import com.linecorp.bot.audience.model.GetAudienceGroupsResponse;
 import com.linecorp.bot.audience.model.GetSharedAudienceDataResponse;
 import com.linecorp.bot.audience.model.GetSharedAudienceGroupsResponse;
-import com.linecorp.bot.audience.model.UpdateAudienceGroupAuthorityLevelRequest;
 import com.linecorp.bot.audience.model.UpdateAudienceGroupDescriptionRequest;
 import com.linecorp.bot.client.base.ApiAuthenticatedClientBuilder;
 import com.linecorp.bot.client.base.Result;
@@ -46,17 +44,6 @@
 @javax.annotation.Generated(value = "com.linecorp.bot.codegen.LineJavaCodegenGenerator")
 public interface ManageAudienceClient {
 
-  /**
-   * Activate audience
-   *
-   * @param audienceGroupId The audience ID. (required)
-   * @see <a href="https://developers.line.biz/en/reference/messaging-api/#activate-audience-group">
-   *     Documentation</a>
-   */
-  @PUT("/v2/bot/audienceGroup/{audienceGroupId}/activate")
-  CompletableFuture<Result<Void>> activateAudienceGroup(
-      @Path("audienceGroupId") Long audienceGroupId);
-
   /**
    * Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by
    * JSON)
@@ -128,16 +115,6 @@ CompletableFuture<Result<Void>> deleteAudienceGroup(
   CompletableFuture<Result<GetAudienceDataResponse>> getAudienceData(
       @Path("audienceGroupId") Long audienceGroupId);
 
-  /**
-   * Get the authority level of the audience
-   *
-   * @see <a href="https://developers.line.biz/en/reference/messaging-api/#get-authority-level">
-   *     Documentation</a>
-   */
-  @GET("/v2/bot/audienceGroup/authorityLevel")
-  CompletableFuture<Result<GetAudienceGroupAuthorityLevelResponse>>
-      getAudienceGroupAuthorityLevel();
-
   /**
    * Gets data for more than one audience.
    *
@@ -194,6 +171,9 @@ CompletableFuture<Result<GetSharedAudienceDataResponse>> getSharedAudienceData(
    *     &#x60;OA_MANAGER&#x60;: Return only audiences created with LINE Official Account Manager
    *     (opens new window). &#x60;MESSAGING_API&#x60;: Return only audiences created with Messaging
    *     API. (optional)
+   * @param includesOwnedAudienceGroups true: Include audienceGroups owned by LINE Official Account
+   *     Manager false: Respond only audienceGroups shared by Business Manager (optional, default to
+   *     false)
    * @see <a
    *     href="https://developers.line.biz/en/reference/messaging-api/#get-shared-audience-list">
    *     Documentation</a>
@@ -204,18 +184,8 @@ CompletableFuture<Result<GetSharedAudienceGroupsResponse>> getSharedAudienceGrou
       @Query("description") String description,
       @Query("status") AudienceGroupStatus status,
       @Query("size") Long size,
-      @Query("createRoute") AudienceGroupCreateRoute createRoute);
-
-  /**
-   * Change the authority level of the audience
-   *
-   * @param updateAudienceGroupAuthorityLevelRequest (required)
-   * @see <a href="https://developers.line.biz/en/reference/messaging-api/#change-authority-level">
-   *     Documentation</a>
-   */
-  @PUT("/v2/bot/audienceGroup/authorityLevel")
-  CompletableFuture<Result<Void>> updateAudienceGroupAuthorityLevel(
-      @Body UpdateAudienceGroupAuthorityLevelRequest updateAudienceGroupAuthorityLevelRequest);
+      @Query("createRoute") AudienceGroupCreateRoute createRoute,
+      @Query("includesOwnedAudienceGroups") Boolean includesOwnedAudienceGroups);
 
   /**
    * Renames an existing audience.