Method: partners.devices.findByOwner

ค้นหาอุปกรณ์ที่ลูกค้าอ้างสิทธิ์แล้ว ผลลัพธ์จะมีเฉพาะอุปกรณ์ที่ลงทะเบียนไว้กับตัวแทนจำหน่ายซึ่งระบุโดยอาร์กิวเมนต์ partnerId แต่อุปกรณ์ของลูกค้าที่ซื้อจากตัวแทนจำหน่ายรายอื่นจะไม่ปรากฏในผลการค้นหา

คำขอ HTTP

POST https://androiddeviceprovisioning.googleapis.com/v1/partners/{partnerId}/devices:findByOwner

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
partnerId

string (int64 format)

ต้องระบุ รหัสของพาร์ทเนอร์ตัวแทนจำหน่าย

เนื้อหาของคำขอ

เนื้อหาของคำขอมีข้อมูลที่มีโครงสร้างต่อไปนี้

การแสดง JSON
{
  "pageToken": string,
  "limit": string,
  "sectionType": enum (DeviceProvisioningSectionType),
  "customerId": [
    string
  ],
  "googleWorkspaceCustomerId": [
    string
  ]
}
ช่อง
pageToken

string

โทเค็นที่ระบุหน้าผลลัพธ์ที่จะแสดงผล

limit

string (int64 format)

ต้องระบุ จำนวนอุปกรณ์สูงสุดที่จะแสดงในหน้าผลการค้นหา ต้องอยู่ระหว่าง 1 ถึง 100

sectionType

enum (DeviceProvisioningSectionType)

ต้องระบุ ประเภทส่วนของระเบียนการจัดสรรของอุปกรณ์

customerId[]

string (int64 format)

รายการรหัสลูกค้าที่จะค้นหา

googleWorkspaceCustomerId[]

string

รายการรหัสบัญชี Google Workspace ที่จะค้นหา

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีข้อมูลซึ่งมีโครงสร้างดังต่อไปนี้

คำตอบที่มีอุปกรณ์ที่พบ

การแสดง JSON
{
  "devices": [
    {
      object (Device)
    }
  ],
  "nextPageToken": string,
  "totalSize": integer
}
ช่อง
devices[]

object (Device)

อุปกรณ์ของลูกค้า

nextPageToken

string

โทเค็นที่ใช้เพื่อเข้าถึงผลการค้นหาหน้าถัดไป ละเว้นหากไม่มีผลลัพธ์เพิ่มเติม

totalSize

integer

จำนวนรายการทั้งหมดในรายการโดยไม่คำนึงถึงการใส่เลขหน้า

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

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

สำหรับข้อมูลเพิ่มเติม โปรดดูที่ภาพรวมของ OAuth 2.0