Method: customers.recommendationSubscriptions.mutateRecommendationSubscription

اشتراک داده شده را با پارامترهای کاربردی مربوطه تغییر می دهد.

فهرست خطاهای پرتاب شده: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError داخلی Error MutateError QuotaError RecommendationError RequestError UrlFieldError

درخواست HTTP

POST https://googleads.googleapis.com/v15/customers/{customerId}/recommendationSubscriptions:mutateRecommendationSubscription

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری مشترک.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "operations": [
    {
      object (RecommendationSubscriptionOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
زمینه های
operations[]

object ( RecommendationSubscriptionOperation )

ضروری. فهرست عملیات ایجاد یا به‌روزرسانی.

partialFailure

boolean

اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام می‌شود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است.

validateOnly

boolean

اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج.

responseContentType

enum ( ResponseContentType )

تنظیم نوع محتوای پاسخ. تعیین می کند که آیا منبع قابل تغییر یا فقط نام منبع باید به پست جهش برگردانده شود. منبع قابل تغییر تنها در صورتی برگردانده می شود که منبع دارای فیلد پاسخ مناسب باشد. به عنوان مثال، MutateCampaignResult.campaign.

بدن پاسخگو

پیام پاسخ برای [RecommendationSubscriptionService.MutateRecommendationSubscription]

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "results": [
    {
      object (MutateRecommendationSubscriptionResult)
    }
  ],
  "partialFailureError": {
    object (Status)
  }
}
زمینه های
results[]

object ( MutateRecommendationSubscriptionResult )

نتایج، یک در هر عملیات.

partialFailureError

object ( Status )

خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر خطایی در خارج از عملیات رخ دهد (به عنوان مثال، خطاهای auth)، ما خطای سطح RPC را برمی گردانیم.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.