キーワード プランのキャンペーンのキーワードを作成、更新、削除します。オペレーションのステータスが返されます。
スローされるエラーのリスト: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError KeywordPlanAdGroupKeywordError
HTTP リクエスト
POST https://googleads.googleapis.com/v17/customers/{customerId}/keywordPlanCampaignKeywords:mutate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
必須。キャンペーン キーワードを変更する顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"operations": [
{
object ( |
フィールド | |
---|---|
operations[] |
必須。個々のキーワード プランのキャンペーンのキーワードに対して実行するオペレーションのリストです。 |
partialFailure |
true の場合、正常なオペレーションが実行され、無効なオペレーションはエラーが返されます。false の場合、すべてのオペレーションが有効である場合に限り、1 つのトランザクションですべてのオペレーションが実行されます。デフォルトは false です。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。結果ではなく、エラーのみが返されます。 |
レスポンスの本文
キーワード プラン キャンペーンのキーワード変更に対するレスポンス メッセージです。
成功した場合、レスポンスの本文には次の構造のデータが含まれます。
JSON 表現 |
---|
{ "partialFailureError": { object ( |
フィールド | |
---|---|
partialFailureError |
Partial Failure モードのオペレーション障害に関連するエラーです。partialFailure = true で、すべてのエラーがオペレーション内で発生した場合にのみ返されます。オペレーション以外でエラーが発生した場合(認証エラーなど)は、RPC レベルのエラーを返します。 |
results[] |
変換のすべての結果。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳しくは、OAuth 2.0 の概要をご覧ください。