Create keywords
POST {{baseUrl}}/ad_accounts/:ad_account_id/keywords
Create keywords for following entity types(advertiser, campaign, ad group or ad).
For more information, see Keyword targeting.
Notes:
- Advertisers and campaigns can only be assigned keywords with excluding ('_NEGATIVE').
- All keyword match types are available for ad groups.
For more information on match types, see match type enums.
Returns:
A successful call returns an object containing an array of new keyword objects and an empty "errors" object array.
An unsuccessful call returns an empty keywords array, and, instead, inserts the entire object with nulled/negated properties into the "errors" object array:
{ "keywords": [], "errors": [ { "data": { "archived": null, "match_type": "EXACT", "parent_type": null, "value": "foobar", "parent_id": null, "type": "keyword", "id": null }, "error_messages": [ "Advertisers and Campaigns only accept excluded targeting attributes." ] } }
Rate limit: WRITE.
Request Body
{"keywords"=>[{"match_type"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "value"=>"aliquip Duis nisi in aliqua", "bid"=>200000}, {"match_type"=>{"value"=>"<Error: Too many levels of nesting to fake this schema>"}, "value"=>"commodo fugia", "bid"=>200000}], "parent_id"=>"383791336903426391"}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"errors":[{"data":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"error_messages":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]},{"data":{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},"error_messages":[{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"},{"value":"\u003cError: Too many levels of nesting to fake this schema\u003e"}]}]}