Skip to content

Commit 1884091

Browse files
github-actions[bot]github-actions
and
github-actions
authored
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]>
1 parent 2d4a174 commit 1884091

File tree

6 files changed

+6
-198
lines changed

6 files changed

+6
-198
lines changed

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

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,6 @@ src/main/java/com/linecorp/bot/audience/model/Adaccount.java
44
src/main/java/com/linecorp/bot/audience/model/AddAudienceToAudienceGroupRequest.java
55
src/main/java/com/linecorp/bot/audience/model/Audience.java
66
src/main/java/com/linecorp/bot/audience/model/AudienceGroup.java
7-
src/main/java/com/linecorp/bot/audience/model/AudienceGroupAuthorityLevel.java
87
src/main/java/com/linecorp/bot/audience/model/AudienceGroupCreateRoute.java
98
src/main/java/com/linecorp/bot/audience/model/AudienceGroupFailedType.java
109
src/main/java/com/linecorp/bot/audience/model/AudienceGroupJob.java
@@ -24,9 +23,7 @@ src/main/java/com/linecorp/bot/audience/model/DetailedOwner.java
2423
src/main/java/com/linecorp/bot/audience/model/ErrorDetail.java
2524
src/main/java/com/linecorp/bot/audience/model/ErrorResponse.java
2625
src/main/java/com/linecorp/bot/audience/model/GetAudienceDataResponse.java
27-
src/main/java/com/linecorp/bot/audience/model/GetAudienceGroupAuthorityLevelResponse.java
2826
src/main/java/com/linecorp/bot/audience/model/GetAudienceGroupsResponse.java
2927
src/main/java/com/linecorp/bot/audience/model/GetSharedAudienceDataResponse.java
3028
src/main/java/com/linecorp/bot/audience/model/GetSharedAudienceGroupsResponse.java
31-
src/main/java/com/linecorp/bot/audience/model/UpdateAudienceGroupAuthorityLevelRequest.java
3229
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

Lines changed: 5 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -30,11 +30,9 @@
3030
import com.linecorp.bot.audience.model.CreateImpBasedAudienceGroupRequest;
3131
import com.linecorp.bot.audience.model.CreateImpBasedAudienceGroupResponse;
3232
import com.linecorp.bot.audience.model.GetAudienceDataResponse;
33-
import com.linecorp.bot.audience.model.GetAudienceGroupAuthorityLevelResponse;
3433
import com.linecorp.bot.audience.model.GetAudienceGroupsResponse;
3534
import com.linecorp.bot.audience.model.GetSharedAudienceDataResponse;
3635
import com.linecorp.bot.audience.model.GetSharedAudienceGroupsResponse;
37-
import com.linecorp.bot.audience.model.UpdateAudienceGroupAuthorityLevelRequest;
3836
import com.linecorp.bot.audience.model.UpdateAudienceGroupDescriptionRequest;
3937
import com.linecorp.bot.client.base.ApiAuthenticatedClientBuilder;
4038
import com.linecorp.bot.client.base.Result;
@@ -46,17 +44,6 @@
4644
@javax.annotation.Generated(value = "com.linecorp.bot.codegen.LineJavaCodegenGenerator")
4745
public interface ManageAudienceClient {
4846

49-
/**
50-
* Activate audience
51-
*
52-
* @param audienceGroupId The audience ID. (required)
53-
* @see <a href="https://developers.line.biz/en/reference/messaging-api/#activate-audience-group">
54-
* Documentation</a>
55-
*/
56-
@PUT("/v2/bot/audienceGroup/{audienceGroupId}/activate")
57-
CompletableFuture<Result<Void>> activateAudienceGroup(
58-
@Path("audienceGroupId") Long audienceGroupId);
59-
6047
/**
6148
* Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by
6249
* JSON)
@@ -128,16 +115,6 @@ CompletableFuture<Result<Void>> deleteAudienceGroup(
128115
CompletableFuture<Result<GetAudienceDataResponse>> getAudienceData(
129116
@Path("audienceGroupId") Long audienceGroupId);
130117

131-
/**
132-
* Get the authority level of the audience
133-
*
134-
* @see <a href="https://developers.line.biz/en/reference/messaging-api/#get-authority-level">
135-
* Documentation</a>
136-
*/
137-
@GET("/v2/bot/audienceGroup/authorityLevel")
138-
CompletableFuture<Result<GetAudienceGroupAuthorityLevelResponse>>
139-
getAudienceGroupAuthorityLevel();
140-
141118
/**
142119
* Gets data for more than one audience.
143120
*
@@ -194,6 +171,9 @@ CompletableFuture<Result<GetSharedAudienceDataResponse>> getSharedAudienceData(
194171
* &#x60;OA_MANAGER&#x60;: Return only audiences created with LINE Official Account Manager
195172
* (opens new window). &#x60;MESSAGING_API&#x60;: Return only audiences created with Messaging
196173
* API. (optional)
174+
* @param includesOwnedAudienceGroups true: Include audienceGroups owned by LINE Official Account
175+
* Manager false: Respond only audienceGroups shared by Business Manager (optional, default to
176+
* false)
197177
* @see <a
198178
* href="https://developers.line.biz/en/reference/messaging-api/#get-shared-audience-list">
199179
* Documentation</a>
@@ -204,18 +184,8 @@ CompletableFuture<Result<GetSharedAudienceGroupsResponse>> getSharedAudienceGrou
204184
@Query("description") String description,
205185
@Query("status") AudienceGroupStatus status,
206186
@Query("size") Long size,
207-
@Query("createRoute") AudienceGroupCreateRoute createRoute);
208-
209-
/**
210-
* Change the authority level of the audience
211-
*
212-
* @param updateAudienceGroupAuthorityLevelRequest (required)
213-
* @see <a href="https://developers.line.biz/en/reference/messaging-api/#change-authority-level">
214-
* Documentation</a>
215-
*/
216-
@PUT("/v2/bot/audienceGroup/authorityLevel")
217-
CompletableFuture<Result<Void>> updateAudienceGroupAuthorityLevel(
218-
@Body UpdateAudienceGroupAuthorityLevelRequest updateAudienceGroupAuthorityLevelRequest);
187+
@Query("createRoute") AudienceGroupCreateRoute createRoute,
188+
@Query("includesOwnedAudienceGroups") Boolean includesOwnedAudienceGroups);
219189

220190
/**
221191
* Renames an existing audience.

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

Lines changed: 0 additions & 49 deletions
This file was deleted.

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

Lines changed: 0 additions & 55 deletions
This file was deleted.

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

Lines changed: 0 additions & 55 deletions
This file was deleted.

line-openapi

0 commit comments

Comments
 (0)