Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

تمام اطلاعات مشتری را برای یک مجوز جهانی فهرست کاربر فهرست می‌کند.

این ویژگی فقط برای شرکای داده در دسترس است.

درخواست HTTP

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

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

پارامترهای مسیر

پارامترها
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) استفاده نکنید.

عملیات پشتیبانی شده:

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

توابع پشتیبانی‌شده: - IN(field, value1, value2, ...) : اگر فیلد با هر یک از مقادیر مطابقت داشته باشد، مقدار درست را برمی‌گرداند. مثال: IN(user_list_id, 123, 456)

فیلدهای پشتیبانی نشده:

  • name (به جای آن از متد get استفاده کنید)
  • historical_pricings و تمام زیرفیلدهای آن
  • pricing.start_time
  • pricing.end_time
pageSize

integer

اختیاری. حداکثر تعداد لایسنس‌هایی که باید برگردانده شوند. سرویس ممکن است کمتر از این مقدار را برگرداند. در صورت عدم تعیین، حداکثر ۵۰ لایسنس برگردانده خواهد شد. حداکثر مقدار ۱۰۰۰ است؛ مقادیر بالاتر از ۱۰۰۰ به ۱۰۰۰ کاهش داده می‌شوند.

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

فهرست کاربرانمجوز جهانیاطلاعات مشتری

اطلاعات مربوط به مشتری یک مجوز سراسری در فهرست کاربران. این اطلاعات به طور خودکار توسط سیستم هنگام خرید مجوز سراسری توسط مشتری ایجاد می‌شود.

نمایش 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 )

فقط خروجی. وضعیت مجوز کاربر - فعال یا غیرفعال.

pricing

object ( UserListLicensePricing )

فقط خروجی. قیمت‌گذاری مجوز UserListDirect.

clientAccountType

enum ( UserListLicenseClientAccountType )

فقط خروجی. نوع محصول مشتری که لیست کاربران به آن مجوز داده می‌شود.

clientAccountId

string ( int64 format)

فقط خروجی. شناسه مشتری کلاینت که لیست کاربران به آن مجوز داده می‌شود.

clientAccountDisplayName

string

فقط خروجی. نام مشتری کلاینتی که لیست کاربران به آن مجوز داده می‌شود.

historicalPricings[]

object ( UserListLicensePricing )

فقط خروجی. تاریخچه قیمت‌گذاری این مجوز فهرست کاربران.

metrics

object ( UserListLicenseMetrics )

فقط خروجی. معیارهای مربوط به این مجوز

این فیلد فقط در صورتی پر می‌شود که تاریخ شروع و پایان در فراخوانی userListGlobalLicenseCustomerInfos.list تنظیم شده باشد.