پیوندهای مجموعه آیتم فید را ایجاد، بهروزرسانی یا حذف میکند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError HeaderError داخلی خطا QuotaError RequestError
درخواست HTTP
POST https://googleads.googleapis.com/v17/customers/{customerId}/feedItemSetLinks:mutate
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که پیوندهای مجموعه آیتم فید او در حال تغییر است. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{
"operations": [
{
object ( |
زمینه های | |
---|---|
operations[] | ضروری. فهرست عملیاتی که باید روی پیوندهای مجموعه آیتمهای خوراک فردی انجام شود. |
partialFailure | اگر درست باشد، عملیات موفقیت آمیز انجام می شود و عملیات نامعتبر خطاها را برمی گرداند. اگر نادرست باشد، تمام عملیات در یک تراکنش انجام میشود، اگر و تنها در صورتی که همه آنها معتبر باشند. پیش فرض نادرست است. |
validateOnly | اگر درست باشد، درخواست تایید می شود اما اجرا نمی شود. فقط خطاها برگردانده می شوند، نه نتایج. |
بدن پاسخگو
پیام پاسخ برای جهش پیوند مجموعه مورد فید.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "results": [ { object ( |
زمینه های | |
---|---|
results[] | همه نتایج برای جهش. |
partialFailureError | خطاهایی که مربوط به خرابی عملیات در حالت شکست جزئی است. فقط زمانی که partialFailure = true باشد و تمام خطاها در داخل عملیات رخ دهد، برگردانده می شود. اگر هر گونه خطایی خارج از عملیات رخ دهد (مثلاً خطاهای تأیید اعتبار)، یک خطای سطح RPC را برمی گردانیم. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.