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
  • =
  • !=
  • >
  • >=
  • <
  • <=

פונקציות נתמכות: – IN(field, value1, value2, ...): מחזירה true אם השדה תואם לאחד מהערכים. דוגמה: IN(user_list_id, 123, 456)

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

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

integer

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

string

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

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

גוף הבקשה

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

גוף התשובה

תגובה מ- [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.