Method: subscriptions.list

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

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

คำขอ HTTP

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

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

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

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

string

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

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