対応する適用パラメータを使用して、指定されたサブスクリプションをミューテーションします。
スローされるエラーのリスト: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RecommendationError RequestError UrlFieldError
HTTP リクエスト
POST https://googleads.googleapis.com/v16/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
customerId |
必須。登録している顧客の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{ "operations": [ { object ( |
フィールド | |
---|---|
operations[] |
必須。作成または更新のオペレーションのリスト。 |
partialFailure |
true の場合、成功したオペレーションが実行され、無効なオペレーションはエラーを返します。false の場合、すべてのオペレーションが有効な場合にのみ、1 つのトランザクションで実行されます。デフォルトは false です。 |
validateOnly |
true の場合、リクエストは検証されますが、実行されません。エラーのみが返され、結果は返されません。 |
responseContentType |
レスポンスのコンテンツ タイプの設定。ミューテーション後に可変リソースを返すか、リソース名のみを返すかを決定します。変更可能なリソースは、リソースに適切なレスポンス フィールドがある場合にのみ返されます。(例: MutateCampaignResult.campaign)。 |
レスポンスの本文
[RecommendationSubscriptionService.MutateRecommendationSubscription] に対するレスポンス メッセージ
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{ "results": [ { object ( |
フィールド | |
---|---|
results[] |
結果(オペレーションごとに 1 つ)。 |
partialFailureError |
部分障害モードのオペレーションの失敗に関連するエラー。partialFailure = true で、すべてのエラーがオペレーション内で発生した場合にのみ返されます。オペレーションの外部でエラー(認証エラーなど)が発生した場合は、RPC レベルのエラーが返されます。 |
承認スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/adwords
詳細については、OAuth 2.0 の概要をご覧ください。