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
ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์
เนื้อหาของหน้าเว็บนี้ได้รับอนุญาตภายใต้ใบอนุญาตที่ต้องระบุที่มาของครีเอทีฟคอมมอนส์ 4.0 และตัวอย่างโค้ดได้รับอนุญาตภายใต้ใบอนุญาต Apache 2.0 เว้นแต่จะระบุไว้เป็นอย่างอื่น โปรดดูรายละเอียดที่นโยบายเว็บไซต์ Google Developers Java เป็นเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-25 UTC
[null,null,["อัปเดตล่าสุด 2025-07-25 UTC"],[],[],null,["# Method: subscriptions.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.Subscriptions.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists of subscriptions managed by the reseller. The list can be all subscriptions, all of a customer's subscriptions, or all of a customer's transferable subscriptions.\n\nOptionally, this method can filter the response by a `customerNamePrefix`. For more information, see [manage subscriptions](https://developers.google.com/workspace/admin/reseller/v1/how-tos/manage_subscriptions).\n\n### HTTP request\n\n`GET https://reseller.googleapis.com/apps/reseller/v1/subscriptions`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|----------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerAuthToken` | `string` The `customerAuthToken` query string is required when creating a resold account that transfers a direct customer's subscription or transfers another reseller customer's subscription to your reseller management. This is a hexadecimal authentication token needed to complete the subscription transfer. For more information, see the [administrator help center](//support.google.com/a/bin/answer.py?answer=142336). |\n| `customerId` | `string` This can be either the customer's primary domain name or the customer's unique identifier. If the domain name for a customer changes, the old domain name cannot be used to access the customer, but the customer's unique identifier (as returned by the API) can always be used. We recommend storing the unique identifier in your systems where applicable. |\n| `customerNamePrefix` | `string` When retrieving all of your subscriptions and filtering for specific customers, you can enter a prefix for a customer name. Using an example customer group that includes `exam.com`, `example20.com` and `example.com`: - `exa` -- Returns all customer names that start with 'exa' which could include `exam.com`, `example20.com`, and `example.com`. A name prefix is similar to using a regular expression's asterisk, exa\\*. - `example` -- Returns `example20.com` and `example.com`. \u003cbr /\u003e |\n| `maxResults` | `integer (`[uint32](https://developers.google.com/discovery/v1/type-format)` format)` When retrieving a large list, the `maxResults` is the maximum number of results per page. The `nextPageToken` value takes you to the next page. The default is 20. |\n| `pageToken` | `string` Token to specify next page in the list |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA subscription manages the relationship of a Google customer's payment plan with a product's SKU, user licenses, 30-day free trial status, and renewal options. A primary role of a reseller is to manage the Google customer's subscriptions.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"subscriptions\": [ { object (/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies the resource as a collection of subscriptions. Value: reseller#subscriptions |\n| `subscriptions[]` | `object (`[Subscription](/workspace/admin/reseller/reference/rest/v1/subscriptions#Subscription)`)` The subscriptions in this page of results. |\n| `nextPageToken` | `string` The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/apps.order`\n- `\n https://www.googleapis.com/auth/apps.order.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
