اشتراک داده شده را با پارامترهای کاربردی مربوطه تغییر می دهد.
فهرست خطاهای پرتاب شده: 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 | ضروری. شناسه مشتری مشترک. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "operations": [ { object ( |
زمینه های | |
---|---|
operations[] | ضروری. فهرست عملیات ایجاد یا بهروزرسانی. |
partialFailure | اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
responseContentType | تنظیم نوع محتوای پاسخ. تعیین می کند که آیا منبع قابل تغییر یا فقط نام منبع باید به پست جهش برگردانده شود. منبع قابل تغییر تنها در صورتی برگردانده می شود که منبع دارای فیلد پاسخ مناسب باشد. به عنوان مثال، MutateCampaignResult.campaign. |
بدن پاسخگو
پیام پاسخ برای [RecommendationSubscriptionService.MutateRecommendationSubscription]
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "results": [ { object ( |
زمینه های | |
---|---|
results[] | نتایج، یک در هر عملیات. |
partialFailureError | خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر خطایی در خارج از عملیات رخ دهد (به عنوان مثال، خطاهای auth)، ما خطای سطح RPC را برمی گردانیم. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.