Method: accountTypes.accounts.userListGlobalLicenses.userListGlobalLicenseCustomerInfos.list

تعرض هذه السمة جميع معلومات العملاء لترخيص عام لقائمة مستخدمين.

لا تتوفّر هذه الميزة إلا لشركاء البيانات.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى 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 وحالة Snake.

العمليات المتوافقة:

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

الحقول غير المتوافقة:

  • name (استخدِم طريقة GET بدلاً من ذلك)
  • ‫historical_pricings وجميع حقوله الفرعية
  • pricing.start_time
  • pricing.end_time
pageSize

integer

اختياريّ. الحدّ الأقصى لعدد التراخيص المطلوب عرضها. قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 50 ترخيصًا كحدّ أقصى. الحد الأقصى للقيمة هو 1000، وسيتم فرض القيمة 1000 على القيم الأكبر من 1000.
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.