Campaign Negative Keywords

class ad_api.api.sp.CampaignNegativeKeywords(account='default', marketplace: Marketplaces = Marketplaces.EU, credentials=None, proxies=None, verify=True, timeout=None, debug=False, access_token=None)

create_campaign_negative_keywords(self, \*\*kwargs) → ApiResponse:

Creates one or more campaign negative keywords.

body: | REQUIRED {‘description’: ‘An array of keyword objects.}’

‘campaignId’: number, {‘description’: ‘The identifer of the campaign to which the keyword is associated.’}

‘state’: string, {‘description’: ‘The current resource state.’ , ‘Enum’: ‘[ enabled ]’}

‘keywordText’: string, {‘description’: ‘The text of the expression to match against a search query.’}

‘matchType’: string, {‘description’: ‘The type of match.’ , ‘Enum’: ‘[ negativeExact, negativePhrase ]’}

Returns:

ApiResponse

delete_campaign_negative_keyword(self, keywordId, \*\*kwargs) → ApiResponse

Archives a campaign negative keyword.

path keywordId:number | Required. The identifier of an existing keyword.

Returns:

ApiResponse

edit_campaign_negative_keywords(self, \*\*kwargs) → ApiResponse:

Updates one or more campaign negative keywords.

body: | REQUIRED {‘description’: ‘An array of campaign negative keywords with updated values.’}

‘keywordId’: number, {‘description’: ‘The identifer of the campaign to which the keyword is associated.’}

‘state’: string, {‘description’: ‘The current resource state.’ , ‘Enum’: ‘[ deleted ]’}

Returns:

ApiResponse

get_campaign_negative_keyword(self, keywordId, \*\*kwargs) → ApiResponse

Gets a campaign negative keyword specified by identifier.

path keywordId:number | Required. The identifier of an existing keyword.

Returns:

ApiResponse

get_campaign_negative_keyword_extended(self, keywordId, \*\*kwargs) → ApiResponse

Gets a campaign negative keyword that has extended data fields.

path keywordId:number | Required. The identifier of an existing keyword.

Returns:

ApiResponse

list_campaign_negative_keywords(self, \*\*kwargs) → ApiResponse

Gets a list of campaign negative keywords.

query startIndex:integer | Optional. 0-indexed record offset for the result set. Default value : 0

query count:integer | Optional. Number of records to include in the paged response. Defaults to max page size.

query matchTypeFilter:string | Optional. Restricts results to keywords with match types within the specified comma-separated list. Available values : negativePhrase, negativeExact.

query keywordText:string | Optional. Restricts results to keywords that match the specified text exactly.

query campaignIdFilter:string | Optional. A comma-delimited list of campaign identifiers.

query keywordIdFilter:string | Optional. Restricts results to keywords associated with campaigns specified by identifier in the comma-delimited list.

Returns:

ApiResponse

list_campaign_negative_keywords_extended(self, \*\*kwargs) → ApiResponse

Gets a list of campaign negative keywords that have extended data fields.

query startIndex:integer | Optional. 0-indexed record offset for the result set. Default value : 0

query count:integer | Optional. Number of records to include in the paged response. Defaults to max page size.

query matchTypeFilter:string | Optional. Restricts results to keywords with match types within the specified comma-separated list. Available values : negativePhrase, negativeExact.

query keywordText:string | Optional. Restricts results to keywords that match the specified text exactly.

query campaignIdFilter:string | Optional. A comma-delimited list of campaign identifiers.

query keywordIdFilter:string | Optional. Restricts results to keywords associated with campaigns specified by identifier in the comma-delimited list.

Returns:

ApiResponse