Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

מציג את כל פרטי הלקוחות עבור רישיון גלובלי של רשימת משתמשים.

התכונה הזו זמינה רק לשותפי נתונים.

בקשת HTTP

GET https://datamanager.googleapis.com/v1/{parent=accountTypes/*/accounts/*/userListGlobalLicenses/*}/userListGlobalLicenseCustomerInfos

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

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

פרמטרים
parent

string

חובה. הרישיון הגלובלי שפרטי הלקוח שלו נשלחים לבקשה. הפורמט הנדרש הוא accountTypes/{ACCOUNT_TYPE}/accounts/{ACCOUNT_ID}/userListGlobalLicenses/{USER_LIST_GLOBAL_LICENSE_ID}. כדי לכלול בחשבון את כל פרטי הלקוחות של רישיון גלובלי, מחליפים את מזהה הרישיון הגלובלי של רשימת המשתמשים בסימן '-' (לדוגמה, accountTypes/DATA_PARTNER/accounts/123/userListGlobalLicenses/-)

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

פרמטרים
filter

string

אופציונלי. מחרוזת מסנן להחלה על בקשת הרשימה. כל השדות צריכים להיות בצד ימין של כל תנאי (לדוגמה: user_list_id = 123). צריך לציין את השדות באמצעות camel case או snake case. אל תשתמשו בשילוב של camel case ו-snake case.

פעולות נתמכות:

  • AND
  • =
  • !=
  • >
  • >=
  • <
  • <=

שדות שלא נתמכים:

  • ‫name (צריך להשתמש בשיטת get)
  • ‫historical_pricings וכל שדות המשנה שלו
  • pricing.start_time
  • pricing.end_time
pageSize

integer

אופציונלי. המספר המקסימלי של הרישיונות שיוחזרו. יכול להיות שהשירות יחזיר פחות מהערך הזה. אם לא מציינים ערך, המערכת תחזיר עד 50 רישיונות. הערך המקסימלי הוא 1,000. ערכים גבוהים יותר יומרו ל-1,000.
pageToken

string

אופציונלי. טוקן של דף שהתקבל מקריאה קודמת של ListUserListDirectLicense. צריך להזין את הטוקן כדי לאחזר את הדף הבא.

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

גוף הבקשה

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

גוף התשובה

תגובה מה-API‏ [ListUserListGlobalLicensesCustomerInfoRequest][google.ads.datamanager.v1.ListUserListGlobalLicensesCustomerInfoRequest].

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

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

object (UserListGlobalLicenseCustomerInfo)

פרטי הלקוח של הרישיון שצוין בבקשה.
nextPageToken

string

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

היקפי הרשאות

נדרש היקף ההרשאות הבא של OAuth:

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

UserListGlobalLicenseCustomerInfo

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

ייצוג ב-JSON 
{
  "name": string,
  "userListId": string,
  "userListDisplayName": string,
  "licenseType": enum (UserListGlobalLicenseType),
  "status": enum (UserListLicenseStatus),
  "pricing": {
    object (UserListLicensePricing)
  },
  "clientAccountType": enum (UserListLicenseClientAccountType),
  "clientAccountId": string,
  "clientAccountDisplayName": string,
  "historicalPricings": [
    {
      object (UserListLicensePricing)
    }
  ],
  "metrics": {
    object (UserListLicenseMetrics)
  }
}
שדות
name

string

מזהה. שם המשאב של הלקוח עם רישיון גלובלי לרשימת משתמשים.
userListId

string (int64 format)

פלט בלבד. המזהה של רשימת המשתמשים שמוקצה לה רישיון.
userListDisplayName

string

פלט בלבד. השם של רשימת המשתמשים שמוענקת לה רישיון.
licenseType

enum (UserListGlobalLicenseType)

פלט בלבד. סוג המוצר של לקוח הקצה שלמשתמש יש רישיון להשתמש בו ברשימת המשתמשים.
status

enum (UserListLicenseStatus)

פלט בלבד. הסטטוס של UserListDirectLicense – ENABLED או DISABLED.
pricing

object (UserListLicensePricing)

פלט בלבד. תמחור של UserListDirectLicense.
clientAccountType

enum (UserListLicenseClientAccountType)

פלט בלבד. סוג המוצר של לקוח הקצה שלמשתמש יש רישיון להשתמש בו ברשימת המשתמשים.
clientAccountId

string (int64 format)

פלט בלבד. המזהה של לקוח הלקוח שאליו מוענקת הרשאה לשימוש ברשימת המשתמשים.
clientAccountDisplayName

string

פלט בלבד. שם הלקוח של הלקוח שאליו מוענקת הרשאה לשימוש ברשימת המשתמשים.
historicalPricings[]

object (UserListLicensePricing)

פלט בלבד. היסטוריית התמחור של הרישיון של רשימת המשתמשים הזו.
metrics

object (UserListLicenseMetrics)

פלט בלבד. מדדים שקשורים לרישיון הזה

השדה הזה מתמלא רק אם תאריכי ההתחלה והסיום מוגדרים בקריאה userListGlobalLicenseCustomerInfos.list.