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"=>"PHRASE_NEGATIVE", "value"=>"<string>", "bid"=>"<integer>"}, {"match_type"=>nil, "value"=>"<string>", "bid"=>"<integer>"}], "parent_id"=>"3"}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
Accept | string |
RESPONSES
status: OK
{"errors":[{"data":{"match_type":null,"value":"\u003cstring\u003e","archived":true,"id":"5","parent_id":"574","parent_type":"minim exercitation aute","type":"esse ut dolore","bid":"\u003cinteger\u003e"},"error_messages":["\u003cstring\u003e","\u003cstring\u003e"]},{"data":{"match_type":"PHRASE","value":"\u003cstring\u003e","archived":false,"id":"43523983","parent_id":"3368028","parent_type":"voluptate Dui","type":"laborum nostrud dolor","bid":"\u003cinteger\u003e"},"error_messages":["\u003cstring\u003e","\u003cstring\u003e"]}],"keywords":[{"match_type":"BROAD","value":"\u003cstring\u003e","archived":false,"id":"23","parent_id":"364785","parent_type":"deserunt","type":"Duis tempor","bid":"\u003cinteger\u003e"},{"match_type":"EXACT","value":"\u003cstring\u003e","archived":false,"id":"37276513472","parent_id":"923229","parent_type":"aute sunt","type":"aute","bid":"\u003cinteger\u003e"}]}