Method: accounts.promotions.list

تبلیغات را در حساب Merchant Center شما فهرست می کند. پاسخ ممکن است حاوی موارد کمتری نسبت به pageSize باشد. برای تعیین اینکه آیا موارد بیشتری برای درخواست وجود دارد یا خیر، به pageToken تکیه کنید.

پس از درج یا به‌روزرسانی یک تبلیغ، ممکن است چند دقیقه طول بکشد تا تبلیغات پردازش شده به‌روز شده بازیابی شود.

درخواست HTTP

GET https://merchantapi.googleapis.com/promotions/v1beta/{parent=accounts/*}/promotions

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

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

مولفه های
parent

string

ضروری. حسابی که برای آن تبلیغات پردازش شده فهرست می شود. قالب: accounts/{account}

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

مولفه های
pageSize

integer

فقط خروجی حداکثر تعداد تبلیغات برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. حداکثر مقدار 1000 است. مقادیر بالای 1000 به 1000 اجباری می شود. اگر مشخص نباشد، حداکثر تعداد تبلیغات برگردانده می شود.

pageToken

string

فقط خروجی یک نشانه صفحه، دریافت شده از تماس قبلی promotions.list . این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به promotions.list باید با تماسی که توکن صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پیام پاسخ برای روش promotions.list .

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

نمایندگی JSON
{
  "promotions": [
    {
      object (Promotion)
    }
  ],
  "nextPageToken": string
}
زمینه های
promotions[]

object ( Promotion )

تبلیغات پردازش شده از حساب مشخص شده.

nextPageToken

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

محدوده مجوز

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

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

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