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 Case และ Snake Case

การดำเนินการที่รองรับ

  • 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