Method: accounts.promotions.list

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

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

בקשת HTTP

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

כתובת ה-URL משתמשת בתחביר של Transcoding של gRPC.

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

פרמטרים
parent

string

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

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

פרמטרים
pageSize

integer

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