Method: subscriptions.list

รายการการสมัครใช้บริการที่จัดการโดยตัวแทนจำหน่าย รายการดังกล่าวอาจเป็นการสมัครใช้บริการทั้งหมด การสมัครใช้บริการทั้งหมดของลูกค้า หรือการสมัครใช้บริการทั้งหมดของลูกค้าที่โอนได้

วิธีนี้สามารถกรองคำตอบตาม customerNamePrefix ได้ด้วย (ไม่บังคับ) ดูข้อมูลเพิ่มเติมได้ที่จัดการการสมัครใช้บริการ

คำขอ HTTP

GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions

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

พารามิเตอร์การค้นหา

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

string

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

customerId

string

ซึ่งอาจเป็นชื่อโดเมนหลักของลูกค้าหรือตัวระบุที่ไม่ซ้ำของลูกค้าก็ได้ หากชื่อโดเมนของลูกค้ามีการเปลี่ยนแปลง คุณจะไม่สามารถเข้าถึงลูกค้าโดยใช้ชื่อโดเมนเดิมได้ แต่จะใช้ตัวระบุที่ไม่ซ้ำกันของลูกค้า (ตามที่ API แสดงผล) ได้เสมอ เราขอแนะนำให้จัดเก็บตัวระบุที่ไม่ซ้ำกันในระบบของคุณ (หากมี)

customerNamePrefix

string

เมื่อเรียกข้อมูลการสมัครใช้บริการทั้งหมดและกรองหาลูกค้าที่ต้องการ คุณสามารถป้อนคำนำหน้าสำหรับชื่อลูกค้าได้ การใช้ตัวอย่างกลุ่มลูกค้าที่มี exam.com, example20.com และ example.com

  • exa -- แสดงผลชื่อลูกค้าทั้งหมดที่ขึ้นต้นด้วย "exa" ซึ่งอาจรวมถึง exam.com, example20.com และ example.com คำนำหน้าชื่อคล้ายกับการใช้เครื่องหมายดอกจันของนิพจน์ทั่วไปอย่าง exa*
  • example -- แสดงผล example20.com และ example.com

maxResults

integer (uint32 format)

เมื่อดึงข้อมูลรายการขนาดใหญ่ maxResults คือจํานวนผลลัพธ์สูงสุดต่อหน้า ค่า nextPageToken จะนําคุณไปยังหน้าถัดไป ค่าเริ่มต้นคือ 20

pageToken

string

โทเค็นสำหรับระบุหน้าถัดไปในรายการ

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

เนื้อหาของคำขอต้องว่างเปล่า

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

การสมัครใช้บริการจะจัดการความสัมพันธ์ระหว่างแพ็กเกจการชำระเงินของลูกค้า Google กับ SKU ของผลิตภัณฑ์ ใบอนุญาตของผู้ใช้ สถานะช่วงทดลองใช้ฟรี 30 วัน และตัวเลือกการต่ออายุ บทบาทหลักของตัวแทนจำหน่ายคือการเป็นผู้จัดการการสมัครใช้บริการของลูกค้า Google

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

การแสดง JSON
{
  "kind": string,
  "subscriptions": [
    {
      object (Subscription)
    }
  ],
  "nextPageToken": string
}
ช่อง
kind

string

ระบุทรัพยากรเป็นคอลเล็กชันการติดตาม ค่า: reseller#subscriptions

subscriptions[]

object (Subscription)

การติดตามในหน้าผลการค้นหานี้

nextPageToken

string

โทเค็นการต่อชุด ใช้เพื่อเลื่อนดูชุดผลลัพธ์ขนาดใหญ่ ระบุค่านี้ในคำขอถัดไปเพื่อแสดงผลลัพธ์ในหน้าถัดไป

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

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

  • https://www.googleapis.com/auth/apps.order
  • https://www.googleapis.com/auth/apps.order.readonly

ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์