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

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