Method: subscriptions.list

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

אפשר גם לסנן את התשובה לפי customerNamePrefix באמצעות השיטה הזו. מידע נוסף זמין במאמר ניהול מינויים.

בקשת HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

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

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

פרמטרים
customerAuthToken

string

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

string

זה יכול להיות שם הדומיין הראשי של הלקוח או המזהה הייחודי של הלקוח. אם שם הדומיין של לקוח ישתנה, לא תוכלו להשתמש בשם הדומיין הישן כדי לגשת ללקוח, אבל תמיד תוכלו להשתמש במזהה הייחודי של הלקוח (כפי שהוא מוחזר על ידי ה-API). מומלץ לאחסן את המזהה הייחודי במערכות שלכם במקרים הרלוונטיים.
customerNamePrefix

string

כשמפעילים אחזור של כל המינויים ומבצעים סינון לפי לקוחות ספציפיים, אפשר להזין קידומת של שם לקוח. קבוצת לקוחות לדוגמה שכוללת את exam.com, ‏ example20.com ו-example.com:

  • exa – הפונקציה מחזירה את כל שמות הלקוחות שמתחילים ב-'exa', כולל exam.com, ‏ example20.com ו-example.com. תוספת לשם דומה לשימוש באסימון הכוכב של ביטוי רגולרי, exa*.
  • example – הפונקציה מחזירה את הערכים example20.com ו-example.com.
maxResults

integer (uint32 format)

כשמאחזרים רשימה גדולה, הערך של maxResults הוא המספר המקסימלי של תוצאות לכל דף. הערך nextPageToken יעביר אתכם לדף הבא. ברירת המחדל היא 20.
pageToken

string

אסימון לציון הדף הבא ברשימה

גוף הבקשה

גוף הבקשה חייב להיות ריק.

גוף התשובה

מינוי מנהל את הקשר בין תוכנית התמחור והתשלומים של לקוח Google לבין מק"ט המוצר, רישיונות המשתמשים, סטטוס תקופת הניסיון בחינם של 30 יום ואפשרויות החידוש. התפקיד העיקרי של המפיץ הוא לנהל את המינויים של לקוחות Google.

אם הפעולה מצליחה, גוף התגובה מכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
שדות
kind

string

מזהה את המשאב כקולקציה של מינויים. ערך: reseller#subscriptions
subscriptions[]

object (Subscription)

המינויים בדף התוצאות הזה.
nextPageToken

string

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

היקפי הרשאה

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

מידע נוסף זמין במדריך ההרשאות.