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.