2
"kind": "discovery#restDescription",
3
"etag": "\"l66ggWbucbkBw9Lpos72oziyefE/YC4k2HSQWcnQUrh-4yOyG5WxRbQ\"",
4
"discoveryVersion": "v1",
5
"id": "reseller:v1sandbox",
7
"version": "v1sandbox",
8
"revision": "20140821",
9
"title": "Enterprise Apps Reseller API",
10
"description": "Lets you create and manage your customers and their subscriptions.",
11
"ownerDomain": "google.com",
12
"ownerName": "Google",
14
"x16": "http://www.google.com/images/icons/product/search-16.gif",
15
"x32": "http://www.google.com/images/icons/product/search-32.gif"
17
"documentationLink": "https://developers.google.com/google-apps/reseller/",
19
"limited_availability"
22
"baseUrl": "https://www.googleapis.com/apps/reseller/v1sandbox/",
23
"basePath": "/apps/reseller/v1sandbox/",
24
"rootUrl": "https://www.googleapis.com/",
25
"servicePath": "apps/reseller/v1sandbox/",
30
"description": "Data format for the response.",
36
"Responses with Content-Type of application/json"
42
"description": "Selector specifying which fields to include in a partial response.",
47
"description": "API key. Your API key identifies your project and provides you with API access, quota, and reports. Required unless you provide an OAuth 2.0 token.",
52
"description": "OAuth 2.0 token for the current user.",
57
"description": "Returns response with indentations and line breaks.",
63
"description": "Available to use for quota purposes for server-side applications. Can be any arbitrary string assigned to a user, but should not exceed 40 characters. Overrides userIp if both are provided.",
68
"description": "IP address of the site where the request originates. Use this if you want to enforce per-user limits.",
75
"https://www.googleapis.com/auth/apps.order": {
76
"description": "Manage users on your domain"
78
"https://www.googleapis.com/auth/apps.order.readonly": {
79
"description": "Manage users on your domain"
88
"description": "JSON template for address of a customer.",
92
"description": "Address line 1 of the address."
96
"description": "Address line 2 of the address."
100
"description": "Address line 3 of the address."
104
"description": "Name of the contact person."
108
"description": "ISO 3166 country code."
112
"description": "Identifies the resource as a customer address.",
113
"default": "customers#address"
117
"description": "Name of the locality. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element."
119
"organizationName": {
121
"description": "Name of the organization."
125
"description": "The postal code. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element."
129
"description": "Name of the region. This is in accordance with - http://portablecontacts.net/draft-spec.html#address_element."
133
"ChangePlanRequest": {
134
"id": "ChangePlanRequest",
136
"description": "JSON template for the ChangePlan rpc request.",
140
"description": "Identifies the resource as a subscription change plan request.",
141
"default": "subscriptions#changePlanRequest"
145
"description": "Name of the plan to change to."
149
"description": "Purchase order id for your order tracking purposes."
153
"description": "Number/Limit of seats in the new plan."
160
"description": "JSON template for a customer.",
164
"description": "The alternate email of the customer."
168
"description": "The domain name of the customer."
172
"description": "The id of the customer."
176
"description": "Identifies the resource as a customer.",
177
"default": "reseller#customer"
181
"description": "The phone number of the customer."
185
"description": "The postal address of the customer."
189
"description": "Ui url for customer resource."
194
"id": "RenewalSettings",
196
"description": "JSON template for a subscription renewal settings.",
200
"description": "Identifies the resource as a subscription renewal setting.",
201
"default": "subscriptions#renewalSettings"
205
"description": "Subscription renewal type."
212
"description": "JSON template for subscription seats.",
216
"description": "Identifies the resource as a subscription change plan request.",
217
"default": "subscriptions#seats"
219
"licensedNumberOfSeats": {
221
"description": "Read only field containing the current number of licensed seats. Resellers can utilize this field to gather insights into usage for FLEXIBLE Google-Apps subscriptions and other secondary subscriptions (e.g. Google-Vault, Drive-storage).",
224
"maximumNumberOfSeats": {
226
"description": "Maximum number of seats that can be purchased. This needs to be provided only for a non-commitment plan. For a commitment plan it is decided by the contract.",
231
"description": "Number of seats to purchase. This is applicable only for a commitment plan.",
237
"id": "Subscription",
239
"description": "JSON template for a subscription.",
243
"description": "Creation time of this subscription in milliseconds since Unix epoch.",
248
"description": "The id of the customer to whom the subscription belongs."
252
"description": "Identifies the resource as a Subscription.",
253
"default": "reseller#subscription"
257
"description": "Plan details of the subscription",
259
"commitmentInterval": {
261
"description": "Interval of the commitment if it is a commitment plan.",
265
"description": "End time of the commitment interval in milliseconds since Unix epoch.",
270
"description": "Start time of the commitment interval in milliseconds since Unix epoch.",
275
"isCommitmentPlan": {
277
"description": "Whether the plan is a commitment plan or not."
281
"description": "The plan name of this subscription's plan."
287
"description": "Purchase order id for your order tracking purposes."
290
"$ref": "RenewalSettings",
291
"description": "Renewal settings of the subscription."
295
"description": "Ui url for subscription resource."
299
"description": "Number/Limit of seats in the new plan."
303
"description": "Name of the sku for which this subscription is purchased."
307
"description": "Status of the subscription."
311
"description": "The id of the subscription."
315
"description": "Transfer related information for the subscription.",
317
"minimumTransferableSeats": {
321
"transferabilityExpirationTime": {
323
"description": "Time when transfer token or intent to transfer will expire.",
330
"description": "Trial Settings of the subscription.",
334
"description": "Whether the subscription is in trial."
338
"description": "End time of the trial in milliseconds since Unix epoch.",
346
"id": "Subscriptions",
348
"description": "JSON template for a subscription list.",
352
"description": "Identifies the resource as a collection of subscriptions.",
353
"default": "reseller#subscriptions"
357
"description": "The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results."
361
"description": "The subscriptions in this page of results.",
363
"$ref": "Subscription"
373
"id": "reseller.customers.get",
374
"path": "customers/{customerId}",
376
"description": "Gets a customer resource if one exists and is owned by the reseller.",
380
"description": "Id of the Customer",
392
"https://www.googleapis.com/auth/apps.order",
393
"https://www.googleapis.com/auth/apps.order.readonly"
397
"id": "reseller.customers.insert",
399
"httpMethod": "POST",
400
"description": "Creates a customer resource if one does not already exist.",
402
"customerAuthToken": {
404
"description": "An auth token needed for inserting a customer for which domain already exists. Can be generated at https://www.google.com/a/cpanel//TransferToken. Optional.",
415
"https://www.googleapis.com/auth/apps.order"
419
"id": "reseller.customers.patch",
420
"path": "customers/{customerId}",
421
"httpMethod": "PATCH",
422
"description": "Update a customer resource if one it exists and is owned by the reseller. This method supports patch semantics.",
426
"description": "Id of the Customer",
441
"https://www.googleapis.com/auth/apps.order"
445
"id": "reseller.customers.update",
446
"path": "customers/{customerId}",
448
"description": "Update a customer resource if one it exists and is owned by the reseller.",
452
"description": "Id of the Customer",
467
"https://www.googleapis.com/auth/apps.order"
475
"id": "reseller.subscriptions.activate",
476
"path": "customers/{customerId}/subscriptions/{subscriptionId}/activate",
477
"httpMethod": "POST",
478
"description": "Activates a subscription previously suspended by the reseller",
482
"description": "Id of the Customer",
488
"description": "Id of the subscription, which is unique for a customer",
498
"$ref": "Subscription"
501
"https://www.googleapis.com/auth/apps.order"
505
"id": "reseller.subscriptions.changePlan",
506
"path": "customers/{customerId}/subscriptions/{subscriptionId}/changePlan",
507
"httpMethod": "POST",
508
"description": "Changes the plan of a subscription",
512
"description": "Id of the Customer",
518
"description": "Id of the subscription, which is unique for a customer",
528
"$ref": "ChangePlanRequest"
531
"$ref": "Subscription"
534
"https://www.googleapis.com/auth/apps.order"
537
"changeRenewalSettings": {
538
"id": "reseller.subscriptions.changeRenewalSettings",
539
"path": "customers/{customerId}/subscriptions/{subscriptionId}/changeRenewalSettings",
540
"httpMethod": "POST",
541
"description": "Changes the renewal settings of a subscription",
545
"description": "Id of the Customer",
551
"description": "Id of the subscription, which is unique for a customer",
561
"$ref": "RenewalSettings"
564
"$ref": "Subscription"
567
"https://www.googleapis.com/auth/apps.order"
571
"id": "reseller.subscriptions.changeSeats",
572
"path": "customers/{customerId}/subscriptions/{subscriptionId}/changeSeats",
573
"httpMethod": "POST",
574
"description": "Changes the seats configuration of a subscription",
578
"description": "Id of the Customer",
584
"description": "Id of the subscription, which is unique for a customer",
597
"$ref": "Subscription"
600
"https://www.googleapis.com/auth/apps.order"
604
"id": "reseller.subscriptions.delete",
605
"path": "customers/{customerId}/subscriptions/{subscriptionId}",
606
"httpMethod": "DELETE",
607
"description": "Cancels/Downgrades a subscription.",
611
"description": "Id of the Customer",
617
"description": "Whether the subscription is to be fully cancelled or downgraded",
624
"enumDescriptions": [
625
"Cancels the subscription immediately",
626
"Downgrades a Google Apps for Business subscription to Google Apps",
627
"Suspends the subscriptions for 4 days before cancelling it"
633
"description": "Id of the subscription, which is unique for a customer",
644
"https://www.googleapis.com/auth/apps.order"
648
"id": "reseller.subscriptions.get",
649
"path": "customers/{customerId}/subscriptions/{subscriptionId}",
651
"description": "Gets a subscription of the customer.",
655
"description": "Id of the Customer",
661
"description": "Id of the subscription, which is unique for a customer",
671
"$ref": "Subscription"
674
"https://www.googleapis.com/auth/apps.order",
675
"https://www.googleapis.com/auth/apps.order.readonly"
679
"id": "reseller.subscriptions.insert",
680
"path": "customers/{customerId}/subscriptions",
681
"httpMethod": "POST",
682
"description": "Creates/Transfers a subscription for the customer.",
684
"customerAuthToken": {
686
"description": "An auth token needed for transferring a subscription. Can be generated at https://www.google.com/a/cpanel/customer-domain/TransferToken. Optional.",
691
"description": "Id of the Customer",
700
"$ref": "Subscription"
703
"$ref": "Subscription"
706
"https://www.googleapis.com/auth/apps.order"
710
"id": "reseller.subscriptions.list",
711
"path": "subscriptions",
713
"description": "Lists subscriptions of a reseller, optionally filtered by a customer name prefix.",
715
"customerAuthToken": {
717
"description": "An auth token needed if the customer is not a resold customer of this reseller. Can be generated at https://www.google.com/a/cpanel/customer-domain/TransferToken.Optional.",
722
"description": "Id of the Customer",
725
"customerNamePrefix": {
727
"description": "Prefix of the customer's domain name by which the subscriptions should be filtered. Optional",
732
"description": "Maximum number of results to return",
740
"description": "Token to specify next page in the list",
745
"$ref": "Subscriptions"
748
"https://www.googleapis.com/auth/apps.order",
749
"https://www.googleapis.com/auth/apps.order.readonly"
752
"startPaidService": {
753
"id": "reseller.subscriptions.startPaidService",
754
"path": "customers/{customerId}/subscriptions/{subscriptionId}/startPaidService",
755
"httpMethod": "POST",
756
"description": "Starts paid service of a trial subscription",
760
"description": "Id of the Customer",
766
"description": "Id of the subscription, which is unique for a customer",
776
"$ref": "Subscription"
779
"https://www.googleapis.com/auth/apps.order"
783
"id": "reseller.subscriptions.suspend",
784
"path": "customers/{customerId}/subscriptions/{subscriptionId}/suspend",
785
"httpMethod": "POST",
786
"description": "Suspends an active subscription",
790
"description": "Id of the Customer",
796
"description": "Id of the subscription, which is unique for a customer",
806
"$ref": "Subscription"
809
"https://www.googleapis.com/auth/apps.order"