Skip to content

@line/bot-sdk


@line/bot-sdk / manageAudience / ManageAudienceClient

Class: ManageAudienceClient

Defined in: lib/manage-audience/api/manageAudienceClient.ts:53

See

LineBotClient for a unified interface that wraps this client.

Constructors

Constructor

new ManageAudienceClient(config): ManageAudienceClient

Defined in: lib/manage-audience/api/manageAudienceClient.ts:56

Parameters

config

httpClientConfig

Returns

ManageAudienceClient

Methods

addAudienceToAudienceGroup()

addAudienceToAudienceGroup(addAudienceToAudienceGroupRequest): Promise<MessageAPIResponseBase>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:73

Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by JSON)

Parameters

addAudienceToAudienceGroupRequest

AddAudienceToAudienceGroupRequest

Returns

Promise<MessageAPIResponseBase>

See

Documentation


addAudienceToAudienceGroupWithHttpInfo()

addAudienceToAudienceGroupWithHttpInfo(addAudienceToAudienceGroupRequest): Promise<ApiResponseType<MessageAPIResponseBase>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:90

Add user IDs or Identifiers for Advertisers (IFAs) to an audience for uploading user IDs (by JSON). This method includes HttpInfo object to return additional information.

Parameters

addAudienceToAudienceGroupRequest

AddAudienceToAudienceGroupRequest

Returns

Promise<ApiResponseType<MessageAPIResponseBase>>

See

Documentation


createAudienceGroup()

createAudienceGroup(createAudienceGroupRequest): Promise<CreateAudienceGroupResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:109

Create audience for uploading user IDs (by JSON)

Parameters

createAudienceGroupRequest

CreateAudienceGroupRequest

Returns

Promise<CreateAudienceGroupResponse>

See

Documentation


createAudienceGroupWithHttpInfo()

createAudienceGroupWithHttpInfo(createAudienceGroupRequest): Promise<ApiResponseType<CreateAudienceGroupResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:124

Create audience for uploading user IDs (by JSON). This method includes HttpInfo object to return additional information.

Parameters

createAudienceGroupRequest

CreateAudienceGroupRequest

Returns

Promise<ApiResponseType<CreateAudienceGroupResponse>>

See

Documentation


createClickBasedAudienceGroup()

createClickBasedAudienceGroup(createClickBasedAudienceGroupRequest): Promise<CreateClickBasedAudienceGroupResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:143

Create audience for click-based retargeting

Parameters

createClickBasedAudienceGroupRequest

CreateClickBasedAudienceGroupRequest

Returns

Promise<CreateClickBasedAudienceGroupResponse>

See

Documentation


createClickBasedAudienceGroupWithHttpInfo()

createClickBasedAudienceGroupWithHttpInfo(createClickBasedAudienceGroupRequest): Promise<ApiResponseType<CreateClickBasedAudienceGroupResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:160

Create audience for click-based retargeting. This method includes HttpInfo object to return additional information.

Parameters

createClickBasedAudienceGroupRequest

CreateClickBasedAudienceGroupRequest

Returns

Promise<ApiResponseType<CreateClickBasedAudienceGroupResponse>>

See

Documentation


createImpBasedAudienceGroup()

createImpBasedAudienceGroup(createImpBasedAudienceGroupRequest): Promise<CreateImpBasedAudienceGroupResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:179

Create audience for impression-based retargeting

Parameters

createImpBasedAudienceGroupRequest

CreateImpBasedAudienceGroupRequest

Returns

Promise<CreateImpBasedAudienceGroupResponse>

See

Documentation


createImpBasedAudienceGroupWithHttpInfo()

createImpBasedAudienceGroupWithHttpInfo(createImpBasedAudienceGroupRequest): Promise<ApiResponseType<CreateImpBasedAudienceGroupResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:196

Create audience for impression-based retargeting. This method includes HttpInfo object to return additional information.

Parameters

createImpBasedAudienceGroupRequest

CreateImpBasedAudienceGroupRequest

Returns

Promise<ApiResponseType<CreateImpBasedAudienceGroupResponse>>

See

Documentation


deleteAudienceGroup()

deleteAudienceGroup(audienceGroupId): Promise<MessageAPIResponseBase>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:212

Delete audience

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<MessageAPIResponseBase>

See

Documentation


deleteAudienceGroupWithHttpInfo()

deleteAudienceGroupWithHttpInfo(audienceGroupId): Promise<ApiResponseType<MessageAPIResponseBase>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:225

Delete audience. This method includes HttpInfo object to return additional information.

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<ApiResponseType<MessageAPIResponseBase>>

See

Documentation


getAudienceData()

getAudienceData(audienceGroupId): Promise<GetAudienceDataResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:244

Gets audience data.

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<GetAudienceDataResponse>

See

Documentation


getAudienceDataWithHttpInfo()

getAudienceDataWithHttpInfo(audienceGroupId): Promise<ApiResponseType<GetAudienceDataResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:257

Gets audience data.. This method includes HttpInfo object to return additional information.

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<ApiResponseType<GetAudienceDataResponse>>

See

Documentation


getAudienceGroups()

getAudienceGroups(page, description?, status?, size?, includesExternalPublicGroups?, createRoute?): Promise<GetAudienceGroupsResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:281

Gets data for more than one audience.

Parameters

page

number

The page to return when getting (paginated) results. Must be 1 or higher.

description?

string

The name of the audience(s) to return. You can search for partial matches. This is case-insensitive, meaning AUDIENCE and audience are considered identical. If omitted, the name of the audience(s) will not be used as a search criterion.

status?

AudienceGroupStatus

The status of the audience(s) to return. If omitted, the status of the audience(s) will not be used as a search criterion.

size?

number

The number of audiences per page. Default: 20 Max: 40

includesExternalPublicGroups?

boolean

true (default): Get public audiences created in all channels linked to the same bot. false: Get audiences created in the same channel.

createRoute?

AudienceGroupCreateRoute

How the audience was created. If omitted, all audiences are included. OA_MANAGER: Return only audiences created with LINE Official Account Manager (opens new window). MESSAGING_API: Return only audiences created with Messaging API.

Returns

Promise<GetAudienceGroupsResponse>

See

Documentation


getAudienceGroupsWithHttpInfo()

getAudienceGroupsWithHttpInfo(page, description?, status?, size?, includesExternalPublicGroups?, createRoute?): Promise<ApiResponseType<GetAudienceGroupsResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:313

Gets data for more than one audience.. This method includes HttpInfo object to return additional information.

Parameters

page

number

The page to return when getting (paginated) results. Must be 1 or higher.

description?

string

The name of the audience(s) to return. You can search for partial matches. This is case-insensitive, meaning AUDIENCE and audience are considered identical. If omitted, the name of the audience(s) will not be used as a search criterion.

status?

AudienceGroupStatus

The status of the audience(s) to return. If omitted, the status of the audience(s) will not be used as a search criterion.

size?

number

The number of audiences per page. Default: 20 Max: 40

includesExternalPublicGroups?

boolean

true (default): Get public audiences created in all channels linked to the same bot. false: Get audiences created in the same channel.

createRoute?

AudienceGroupCreateRoute

How the audience was created. If omitted, all audiences are included. OA_MANAGER: Return only audiences created with LINE Official Account Manager (opens new window). MESSAGING_API: Return only audiences created with Messaging API.

Returns

Promise<ApiResponseType<GetAudienceGroupsResponse>>

See

Documentation


getSharedAudienceData()

getSharedAudienceData(audienceGroupId): Promise<GetSharedAudienceDataResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:349

Gets audience data.

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<GetSharedAudienceDataResponse>

See

Documentation


getSharedAudienceDataWithHttpInfo()

getSharedAudienceDataWithHttpInfo(audienceGroupId): Promise<ApiResponseType<GetSharedAudienceDataResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:362

Gets audience data.. This method includes HttpInfo object to return additional information.

Parameters

audienceGroupId

number

The audience ID.

Returns

Promise<ApiResponseType<GetSharedAudienceDataResponse>>

See

Documentation


getSharedAudienceGroups()

getSharedAudienceGroups(page, description?, status?, size?, createRoute?, includesOwnedAudienceGroups?): Promise<GetSharedAudienceGroupsResponse>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:386

Gets data for more than one audience, including those shared by the Business Manager.

Parameters

page

number

The page to return when getting (paginated) results. Must be 1 or higher.

description?

string

The name of the audience(s) to return. You can search for partial matches. This is case-insensitive, meaning AUDIENCE and audience are considered identical. If omitted, the name of the audience(s) will not be used as a search criterion.

status?

AudienceGroupStatus

The status of the audience(s) to return. If omitted, the status of the audience(s) will not be used as a search criterion.

size?

number

The number of audiences per page. Default: 20 Max: 40

createRoute?

AudienceGroupCreateRoute

How the audience was created. If omitted, all audiences are included. OA_MANAGER: Return only audiences created with LINE Official Account Manager (opens new window). MESSAGING_API: Return only audiences created with Messaging API.

includesOwnedAudienceGroups?

boolean

true: Include audienceGroups owned by LINE Official Account Manager false: Respond only audienceGroups shared by Business Manager

Returns

Promise<GetSharedAudienceGroupsResponse>

See

Documentation


getSharedAudienceGroupsWithHttpInfo()

getSharedAudienceGroupsWithHttpInfo(page, description?, status?, size?, createRoute?, includesOwnedAudienceGroups?): Promise<ApiResponseType<GetSharedAudienceGroupsResponse>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:418

Gets data for more than one audience, including those shared by the Business Manager.. This method includes HttpInfo object to return additional information.

Parameters

page

number

The page to return when getting (paginated) results. Must be 1 or higher.

description?

string

The name of the audience(s) to return. You can search for partial matches. This is case-insensitive, meaning AUDIENCE and audience are considered identical. If omitted, the name of the audience(s) will not be used as a search criterion.

status?

AudienceGroupStatus

The status of the audience(s) to return. If omitted, the status of the audience(s) will not be used as a search criterion.

size?

number

The number of audiences per page. Default: 20 Max: 40

createRoute?

AudienceGroupCreateRoute

How the audience was created. If omitted, all audiences are included. OA_MANAGER: Return only audiences created with LINE Official Account Manager (opens new window). MESSAGING_API: Return only audiences created with Messaging API.

includesOwnedAudienceGroups?

boolean

true: Include audienceGroups owned by LINE Official Account Manager false: Respond only audienceGroups shared by Business Manager

Returns

Promise<ApiResponseType<GetSharedAudienceGroupsResponse>>

See

Documentation


updateAudienceGroupDescription()

updateAudienceGroupDescription(audienceGroupId, updateAudienceGroupDescriptionRequest): Promise<MessageAPIResponseBase>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:455

Renames an existing audience.

Parameters

audienceGroupId

number

The audience ID.

updateAudienceGroupDescriptionRequest

UpdateAudienceGroupDescriptionRequest

Returns

Promise<MessageAPIResponseBase>

See

Documentation


updateAudienceGroupDescriptionWithHttpInfo()

updateAudienceGroupDescriptionWithHttpInfo(audienceGroupId, updateAudienceGroupDescriptionRequest): Promise<ApiResponseType<MessageAPIResponseBase>>

Defined in: lib/manage-audience/api/manageAudienceClient.ts:475

Renames an existing audience.. This method includes HttpInfo object to return additional information.

Parameters

audienceGroupId

number

The audience ID.

updateAudienceGroupDescriptionRequest

UpdateAudienceGroupDescriptionRequest

Returns

Promise<ApiResponseType<MessageAPIResponseBase>>

See

Documentation