Method: accounts.promotions.list

בתיבת הדו-שיח הזו מפורטים המבצעים בחשבון Merchant Center שלכם. התשובה עשויה להכיל פחות פריטים ממה שצוין על ידי pageSize. אפשר להסתמך על pageToken כדי לדעת אם יש פריטים נוספים שצריך לבקש.

אחרי שמוסיפים או מעדכנים מבצע, יכול להיות שיחלפו כמה דקות עד שאפשר יהיה לאחזר את המבצע המעודכן לאחר עיבוד.

בקשת HTTP

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

בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.

פרמטרים של נתיב

פרמטרים
parent

string

חובה. החשבון שעבורו רוצים להציג מבצעים שעובדו. פורמט: accounts/{account}

פרמטרים של שאילתה

פרמטרים
pageSize

integer

פלט בלבד. המספר המקסימלי של מבצעים שצריך להחזיר. ייתכן שהשירות יחזיר פחות מהערך הזה. הערך המקסימלי הוא 1,000. ערכים מעל 1,000 יועברו ל-1,000. אם לא צויין ערך, יוחזר מספר המבצעים המקסימלי.
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.