!# Reseller - [API documentation](#api-documentation) - [Notes](#notes) - [Manage Multiple Domains](#manage-multiple-domains) - [Definitions](#definitions) - [Manage Resold Customers](#manage-resold-customers) - [Display Resold Customers](#display-resold-customers) - [Manage Resold Subscriptions](#manage-resold-subscriptions) - [Display Resold Subscriptions](#display-resold-subscriptions) ## API documentation * https://developers.google.com/admin-sdk/reseller/v1/reference/customers * https://developers.google.com/admin-sdk/reseller/v1/reference/subscriptions ## Notes Updated handling of `seats` option in `gam create|update resoldsubscription` to properly assign the API fields `numberOfSeats` and `maximumNumberOfSeats`. Prior to version 6.50.00, this is how the `seats ` option was processed: * Plan name `ANNUAL_MONTHLY_PAY` or `ANNUAL_YEARLY_PAY` * `seats ` - `` was properly passed to the API * `seats ` - `` was properly passed to the API; `` was passed to the API which ignored it * Plan name `FLEXIBLE` or `TRIAL` * `seats ` - `` was improperly passed to the API; an API error was generated * `seats ` - `` was properly passed to the API; `` was passed to the API which ignored it Now, you can still use the above option which has been corrected or you can specify `seats ` which will be properly passed in the correct form to the API based on plan name. ## Manage Multiple Domains Thanks to Duncan Isaksen-Loxton for a script to help manage multiple domains. * See: https://gist.github.com/65/b5e9cee9b5812b487b8ae3e8256e262b ## Definitions ``` ::= ::= (.)+ ::= @ ::= (email|alternateemail )| (contact|contactname )| (phone|phonenumber )| (name|organizationname )| (address|address1|addressline1 )| (address2|addressline2 )| (address3|addressline3 )| (city|locality )| (state|region )| (zipcode|postal|postalcode )| (country|countrycode ) ::= nv:: | 20gb | drive20gb | googledrivestorage20gb | Google-Drive-storage-20GB | 50gb | drive50gb | googledrivestorage50gb | Google-Drive-storage-50GB | 200gb | drive200gb | googledrivestorage200gb | Google-Drive-storage-200GB | 400gb | drive400gb | googledrivestorage400gb | Google-Drive-storage-400GB | 1tb | drive1tb | googledrivestorage1tb | Google-Drive-storage-1TB | 2tb | drive2tb | googledrivestorage2tb | Google-Drive-storage-2TB | 4tb | drive4tb | googledrivestorage4tb | Google-Drive-storage-4TB | 8tb | drive8tb | googledrivestorage8tb | Google-Drive-storage-8TB | 16tb | drive16tb | googledrivestorage16tb | Google-Drive-storage-16TB | aimeetingsandmessaging | 1010470007 | AI Meetings and Messaging | aisecurity | 1010470006 | AI Security | appsheetcore | 1010380001 | AppSheet Core | appsheetstandard | appsheetenterprisestandard | 1010380002 | AppSheet Enterprise Standard | appsheetplus | appsheetenterpriseplus | 1010380003 | AppSheet Enterprise Plus | assuredcontrols | 1010390001 | Assured Controls | bce | beyondcorp | beyondcorpenterprise | cep | chromeenterprisepremium | 1010400001 | Chrome Enterprise Premium | cdm | chrome | googlechromedevicemanagement | Google-Chrome-Device-Management | cloudidentity | identity | 1010010001 | Cloud Identity | cloudidentitypremium | identitypremium | 1010050001 | Cloud Identity Premium | cloudsearch | 1010350001 | Cloud Search | colabpro | 1010500001 | Colab Pro | colabpro+ | colabproplus | 1010500002 | Colab Pro+ | eeu | 1010490001 | SKU Endpoint Education Upgrade | geminibiz | 1010470003 | Gemini Business | geminiedu | 1010470004 | Gemini Education | geminiedupremium| 1010470005 | Gemini Education Premium | geminient| duetai | 1010470001 | Gemini Enterprise | gsuitebasic | gafb | gafw | basic | Google-Apps-For-Business | gsuitebusiness | gau | gsb | unlimited | Google-Apps-Unlimited | gsuitebusinessarchived | gsbau | businessarchived | 1010340002 | Google Workspace Business - Archived User | gsuiteenterprisearchived | gseau | enterprisearchived | 1010340001 | Google Workspace Enterprise Plus - Archived User | gsuiteenterpriseeducation | gsefe | e4e | 1010310002 | Google Workspace for Education Plus - Legacy | gsuiteenterpriseeducationstudent | gsefes | e4es | 1010310003 | Google Workspace for Education Plus - Legacy (Student) | gsuitegov | gafg | gsuitegovernment | Google-Apps-For-Government | gsuitelite | gal | gsl | lite | Google-Apps-Lite | gwep | workspaceeducationplus | 1010310008 | Google Workspace for Education Plus | gwepstaff | workspaceeducationplusstaff | 1010310009 | Google Workspace for Education Plus (Staff) | gwepstudent | workspaceeducationplusstudent | 1010310010 | Google Workspace for Education Plus (Extra Student)| gwes | workspaceeducationstandard | 1010310005 | Google Workspace for Education Standard | gwesstaff | workspaceeducationstandardstaff | 1010310006 | Google Workspace for Education Standard (Staff) | gwesstudent | workspaceeducationstandardstudent | 1010310007 | Google Workspace for Education Standard (Extra Student) gwetlu | workspaceeducationupgrade | 1010370001 | Google Workspace for Education: Teaching and Learning Upgrade | gwlabs | workspacelabs | 1010470002 | Google Workspace Labs | meetdialing | googlemeetglobaldialing | 1010360001 | Google Meet Global Dialing | postini | gams | gsuitegams | gsuitepostini | gsuitemessagesecurity | Google-Apps-For-Postini | standard | free | Google-Apps | vault | googlevault | Google-Vault | vfe | googlevaultformeremployee | Google-Vault-Former-Employee | voicepremier | gvpremier | googlevoicepremier | 1010330002 | Google Voice Premier voicestandard | gvstandard | googlevoicestandard | 1010330004 | Google Voice Standard | voicestarter | gvstarter | googlevoicestarter | 1010330003 | Google Voice Starter | wsas | plusstorage | 1010430001 | Google Workspace Additional Storage | wsbizplus | workspacebusinessplus | 1010020025 | Google Workspace Business Plus | wsbizplusarchived | workspacebusinessplusarchived | 1010340003 | Google Workspace Business Plus - Archived User | wsbizstan | workspacebusinessstandard | 1010020028 | Google Workspace Business Standard } wsbizstanarchived | workspacebusinessstandardarchived | 1010340006 | Google Workspace Business Standard - Archived User | wsbizstarter | workspacebusinessstarter | wsbizstart | 1010020027 | Google Workspace Business Starter | wsbizstarterarchived | workspacebusinessstarterarchived | 1010340005 | Google Workspace Business Starter - Archived User | wsentess | workspaceenterpriseessentials | 1010060003 | Google Workspace Enterprise Essentials | wsentplus | workspaceenterpriseplus | gae | gse | enterprise | gsuiteenterprise | 1010020020 | Google Workspace Enterprise Plus | wsentstan | workspaceenterprisestandard | 1010020026 | Google Workspace Enterprise Standard | wsentstanarchived | workspaceenterprisestandardarchived | 1010340004 | Google Workspace Enterprise Standard - Archived User | wsentstarter | workspaceenterprisestarter | wes | 1010020029 | Workspace Enterprise Starter | wsess | workspaceesentials | gsuiteessentials | essentials | d4e | driveenterprise | drive4enterprise | 1010060001 | Google Workspace Essentials | wsessplus | workspaceessentialsplus | 1010060005 | Google Workspace Essentials Plus | wsflw | workspacefrontline | workspacefrontlineworker | 1010020030 | Google Workspace Frontline Starter | wsflwstan | workspacefrontlinestan | workspacefrontlineworkerstan | 1010020031 | Google Workspace Frontline Standard ``` ## Manage Resold Customers ``` gam create resoldcustomer (customer_auth_token ) + gam update resoldcustomer [customer_auth_token ] + ``` ## Display Resold Customers ``` gam info resoldcustomer [formatjson] ``` By default, Gam displays the information as an indented list of keys and values. * `formatjson` - Display the fields in JSON format. ## Manage Resold Subscriptions ``` gam create resoldsubscription (sku ) (plan annual_monthly_pay|annual_yearly_pay|flexible|trial) (seats ) [customer_auth_token ] [deal ] [purchaseorderid ] gam update resoldsubscription activate|suspend|startpaidservice| (renewal auto_renew_monthly_pay|auto_renew_yearly_pay|cancel| renew_current_users_monthly_pay|renew_current_users_yearly_pay| switch_to_pay_as_you_go)| (seats )| (plan annual_monthly_pay|annual_yearly_pay|flexible|trial [deal ] [purchaseorderid ] [seats ]) gam delete resoldsubscription cancel|downgrade|transfer_to_direct ``` ## Display Resold Subscriptions ``` gam info resoldsubscription [formatjson] gam show resoldsubscriptions [customerid [customer_auth_token ]] [customer_prefix ] [maxresults ] [formatjson] ``` By default, Gam displays the information as an indented list of keys and values. * `maxresults` - Maximum number of results per page. The default is 100 (maximum). * `formatjson` - Display the fields in JSON format. ``` gam print resoldsubscriptions [todrive *] [customerid [customer_auth_token ]] [customer_prefix ] [maxresults ] [formatjson [quotechar ]] ``` By default, when writing CSV files, Gam uses a quote character of double quote `"`. The quote character is used to enclose columns that contain the quote character itself, the column delimiter (comma by default) and new-line characters. Any quote characters within the column are doubled. When using the `formatjson` option, double quotes are used extensively in the data resulting in hard to read/process output. The `quotechar ` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable output. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used.