Google Workspace Reseller API
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
大规模执行“渠道服务”控制台中提供的常用功能,例如下单和查看客户信息
服务:reseller.googleapis.com
如要调用此服务,我们建议您使用 Google 提供的客户端库。如果您的应用需要使用您自己的库来调用此服务,则在发出 API 请求时应使用以下信息。
发现文档
发现文档是用于说明和使用 REST API 的机器可读规范。它用于构建客户端库、IDE 插件以及与 Google API 交互的其他工具。一项服务可能会提供多个发现文档。此服务提供了以下发现文档:
服务端点
服务端点是指定 API 服务的网络地址的基本网址。一项服务可能有多个服务端点。此服务具有以下服务端点,下面的所有 URI 都与此服务端点相关:
https://reseller.googleapis.com
方法 |
get |
GET /apps/reseller/v1/customers/{customerId}
获取客户账号。 |
insert |
POST /apps/reseller/v1/customers
订购新客户的账号。 |
patch |
PATCH /apps/reseller/v1/customers/{customerId}
更新客户账号的设置。 |
update |
PUT /apps/reseller/v1/customers/{customerId}
更新客户账号的设置。 |
方法 |
getwatchdetails |
GET /apps/reseller/v1/resellernotify/getwatchdetails
返回与转销商对应的手表的所有详细信息。 |
register |
POST /apps/reseller/v1/resellernotify/register
注册转销商以接收通知。 |
unregister |
POST /apps/reseller/v1/resellernotify/unregister
取消转销商的通知接收注册。 |
方法 |
activate |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/activate
激活之前由转销商暂停的订阅。 |
changePlan |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan
更新订阅方案。 |
changeRenewalSettings |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeRenewalSettings
更新用户许可的续订设置。 |
changeSeats |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeSeats
更新订阅的用户许可设置。 |
delete |
DELETE /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}
取消、暂停或将订阅转为直接订阅。 |
get |
GET /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}
获取特定订阅。 |
insert |
POST /apps/reseller/v1/customers/{customerId}/subscriptions
创建或转移订阅。 |
list |
GET /apps/reseller/v1/subscriptions
由转销商管理的订阅列表。 |
startPaidService |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/startPaidService
将 30 天免费试用订阅立即转换为付费服务订阅。 |
suspend |
POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend
暂停有效订阅。 |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2025-07-25。
[null,null,["最后更新时间 (UTC):2025-07-25。"],[],[],null,["# Google Workspace Reseller API\n\nPerform common functions that are available on the Channel Services console at scale, like placing orders and viewing customer information\n\n- [REST Resource: v1.customers](#v1.customers)\n- [REST Resource: v1.resellernotify](#v1.resellernotify)\n- [REST Resource: v1.subscriptions](#v1.subscriptions)\n\nService: reseller.googleapis.com\n--------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://reseller.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://reseller.googleapis.com`\n\nREST Resource: [v1.customers](/workspace/admin/reseller/reference/rest/v1/customers)\n------------------------------------------------------------------------------------\n\n| Methods ||\n|------------------------------------------------------------------------|-----------------------------------------------------------------------------------------|\n| [get](/workspace/admin/reseller/reference/rest/v1/customers/get) | `GET /apps/reseller/v1/customers/{customerId}` Gets a customer account. |\n| [insert](/workspace/admin/reseller/reference/rest/v1/customers/insert) | `POST /apps/reseller/v1/customers` Orders a new customer's account. |\n| [patch](/workspace/admin/reseller/reference/rest/v1/customers/patch) | `PATCH /apps/reseller/v1/customers/{customerId}` Updates a customer account's settings. |\n| [update](/workspace/admin/reseller/reference/rest/v1/customers/update) | `PUT /apps/reseller/v1/customers/{customerId}` Updates a customer account's settings. |\n\nREST Resource: [v1.resellernotify](/workspace/admin/reseller/reference/rest/v1/resellernotify)\n----------------------------------------------------------------------------------------------\n\n| Methods ||\n|-----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------|\n| [getwatchdetails](/workspace/admin/reseller/reference/rest/v1/resellernotify/getwatchdetails) | `GET /apps/reseller/v1/resellernotify/getwatchdetails` Returns all the details of the watch corresponding to the reseller. |\n| [register](/workspace/admin/reseller/reference/rest/v1/resellernotify/register) | `POST /apps/reseller/v1/resellernotify/register` Registers a Reseller for receiving notifications. |\n| [unregister](/workspace/admin/reseller/reference/rest/v1/resellernotify/unregister) | `POST /apps/reseller/v1/resellernotify/unregister` Unregisters a Reseller for receiving notifications. |\n\nREST Resource: [v1.subscriptions](/workspace/admin/reseller/reference/rest/v1/subscriptions)\n--------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| [activate](/workspace/admin/reseller/reference/rest/v1/subscriptions/activate) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/activate` Activates a subscription previously suspended by the reseller. |\n| [changePlan](/workspace/admin/reseller/reference/rest/v1/subscriptions/changePlan) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changePlan` Updates a subscription plan. |\n| [changeRenewalSettings](/workspace/admin/reseller/reference/rest/v1/subscriptions/changeRenewalSettings) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeRenewalSettings` Updates a user license's renewal settings. |\n| [changeSeats](/workspace/admin/reseller/reference/rest/v1/subscriptions/changeSeats) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/changeSeats` Updates a subscription's user license settings. |\n| [delete](/workspace/admin/reseller/reference/rest/v1/subscriptions/delete) | `DELETE /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}` Cancels, suspends, or transfers a subscription to direct. |\n| [get](/workspace/admin/reseller/reference/rest/v1/subscriptions/get) | `GET /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}` Gets a specific subscription. |\n| [insert](/workspace/admin/reseller/reference/rest/v1/subscriptions/insert) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions` Creates or transfer a subscription. |\n| [list](/workspace/admin/reseller/reference/rest/v1/subscriptions/list) | `GET /apps/reseller/v1/subscriptions` Lists of subscriptions managed by the reseller. |\n| [startPaidService](/workspace/admin/reseller/reference/rest/v1/subscriptions/startPaidService) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/startPaidService` Immediately move a 30-day free trial subscription to a paid service subscription. |\n| [suspend](/workspace/admin/reseller/reference/rest/v1/subscriptions/suspend) | `POST /apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}/suspend` Suspends an active subscription. |"]]