In this version of the API, the API supports these Google products and related Stock Keeping Units (SKUs).
- Google Workspace
- Archived User
- Google Drive
- Google Vault
- Chrome Enterprise
- Cloud Identity Free Edition
- Cloud Identity Premium Edition
Google Workspace
Google Workspace offers a rich suite of business-grade hosted email and collaboration tools that can benefit any size organization. For more information, see the benefits of Google Workspace.
Things to note for the API's management of a Google Workspace subscription:
- Active Google Vault or Google Drive subscriptions must be cancelled before the associated Google Workspace subscription is suspended.
- If transferring a customer's Google Workspace subscription and an associated Google Vault or Google Drive subscription, use the batch operation. If you transfer each subscription one at a time, the transfer will result in an error.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
Google Workspace SKUs | |||
Google-Apps |
Google Workspace | 1010020027 |
Google Workspace Business Starter |
1010020028 |
Google Workspace Business Standard | ||
1010020025 |
Google Workspace Business Plus | ||
1010060003 |
Google Workspace Enterprise Essentials | ||
1010020026 |
Google Workspace Enterprise Standard | ||
1010020020 |
Google Workspace Enterprise Plus (formerly G Suite Enterprise) | ||
1010060001 |
Google Workspace Essentials (formerly G Suite Essentials) | ||
G Suite & Legacy SKUs | |||
Google-Apps |
Google Workspace | Google-Apps-Unlimited |
G Suite Business |
Google-Apps-For-Business |
G Suite Basic | ||
Google-Apps-Lite |
G Suite Lite | ||
Google-Apps-For-Postini |
Google Apps Message Security |
Upgrades and Downgrades
- For new customers, create a new subscription with the subscriptions.insert method.
- You can upgrade a subscription using the
subscriptions.insert
method with the
skuId
that you want to upgrade to. It isn't possible to upgradeANNUAL_YEARLY_PAY
subscriptions, but you can switch toFLEXIBLE
via the subscriptions.changeRenewalSettings method, then perform an adjustment after the renewal event.
You can downgrade a subscription using the subscriptions.insert method with the
skuId
that you want to downgrade to. It isn't possible to downgradeANNUAL_MONTHLY_PAY
andANNUAL_YEARLY_PAY
subscriptions during term, and it cannot be done via renewal settings: the downgrade must be done manually on or after renewal time. We recommend that you switch toFLEXIBLE
via subscriptions.changeRenewalSettings, then perform an adjustment after the renewal event. See more details about downgrades on this Help Center article.Transfer and SKU switch operations cannot be combined. For example, if you have a potential customer who is using
Google-Apps-For-Business
and wants to buyGoogle-Apps-Unlimited
from you, you must transfer the customer first with the existingGoogle-Apps-For-Business
SKU and then switch the SKU toGoogle-Apps-Unlimited
.Upgrades/downgrades start a new subscription and terminate the previous one. For annual plans, a new commitment starts when the call to subscriptions.insert is made.
Upgrade/Downgrade Matrix for G Suite SKUs
This matrix sums up acceptable upgrade and downgrade paths.
From ↓ to → | G Suite Basic | G Suite Business |
G Suite Basic | Upgradeable | |
G Suite Business | Downgradeable |
Upgrade/Downgrade Matrix from G Suite SKUs to Google Workspace SKUs
This matrix sums up acceptable upgrade and downgrade paths.
From ↓ to → | Business Starter | Business Standard | Business Plus | Enterprise Standard | Enterprise Plus |
G Suite Basic | Downgradeable | Upgradeable | Upgradeable | Upgradeable | Upgradeable |
G Suite Business | Downgradeable | Downgradeable | Downgradeable | Upgradeable | Upgradeable |
Upgrade/Downgrade Matrix for Google Workspace SKUs
This matrix sums up acceptable upgrade and downgrade paths.
From ↓ to → | Business Starter | Business Standard | Business Plus | Enterprise Standard | Enterprise Plus |
Business Starter | Upgradeable | Upgradeable | Upgradeable | Upgradeable | |
Business Standard | Downgradeable | Upgradeable | Upgradeable | Upgradeable | |
Business Plus | Downgradeable | Downgradeable | Upgradeable | Upgradeable | |
Enterprise Standard | Downgradeable* | Downgradeable* | Downgradeable* | Upgradeable | |
Enterprise Plus | Downgradeable* | Downgradeable* | Downgradeable* | Downgradeable | |
Enterprise Essentials | Upgradeable** | Upgradeable** |
* - Downgrade from Enterprise SKUs to Business SKUs only permitted if the customer has 300 or fewer seats (in applicable regions)
** - Upgrade from Enterprise Essentials to Enterprise Standard or Enterprise Plus is only permitted if the domain is verified.
Google Workspace Enterprise Essentials
- This subscription is only available as an
ANNUAL_MONTHLY
plan.
Archived User
Archived User enables administrators to manage former employees and their data.
To archive or unarchive multiple users using the Admin SDK APIs, use the
Users.update
API method to
set the archived
boolean field to true
or false
for each user as
appropriate. Refer to the Archive or unarchive a user support page for details.
Things to note for the management of Archived User subscriptions:
- These SKUs have to be purchased in addition to corresponding Google Workspace subscription.
- For example, you should buy "Google Workspace Enterprise Plus – Archived User" licenses for a customer with a Google Workspace Enterprise Plus subscription.
Product ID | Product Name | SKU ID | SKU Name | Unarchival Product ID | Unarchival SKU ID |
---|---|---|---|---|---|
101034 |
Google Workspace Archived User | 1010340001 |
Google Workspace Enterprise Plus - Archived User | Google-Apps |
1010020020 |
1010340002 |
G Suite Business - Archived User | Google-Apps |
Google-Apps-Unlimited |
||
1010340003 |
Google Workspace Business Plus - Archived User | Google-Apps |
1010020025 |
||
1010340004 |
Google Workspace Enterprise Standard - Archived User | Google-Apps |
1010020026 |
Google Workspace Essentials
- This subscription is only available as a
monthly post-pay
FLEXIBLE
plan. - Contact your partner manager for more information if you want to resell Google Workspace Essentials
Postini SKU
Google-Apps-For-Postini
SKU may coexist with a customer's Google Workspace SKU—even via the same reseller. However, Postini SKUs cannot be purchased, they are created when an existing Postini account is migrated.- When you are transferring a customer whose subscriptions include the
Google-Apps-For-Postini
SKU, then you must include this subscription.
G Suite Lite SKU
Google-Apps-Lite
SKU can only be created by resellers when working in conjunction with a Google sales representative. Contact your partner manager for more information.- When you are transferring a customer whose subscriptions include the
Google-Apps-Lite
SKU, then you must include this subscription.
Google Drive
With Google Drive, you can access files, folders, and Google Docs from a web browser or any device where you've installed your Google Drive. No matter what happens to your devices, your files are safely stored in Google Drive. For more information about the Google Drive product, see the administrator help center.
Things to note for the API's management
- This subscription is only available as a
monthly post-pay
FLEXIBLE
plan, and in addition, the customer must first have an active Google Workspace subscription. It is not available for a 30-day free trial. For more information about payment plans, see API Concepts.- You can only add Google Drive to an
ACTIVE
status Google Workspace subscription. Customers must therefore accept Google Workspace terms of services before adding Google Drive. - You can only add Google Drive to a customer with a verified domain.
- You can only add Google Drive to an
- This product subscription is for all of the
Google-Drive-storage
product's SKUs. You are charged only for the assigned SKUs. - Since flexible plan accounts only pay for the services used during the month, a Google Drive subscription does not require updating the renewal settings.
- Active Google Drive subscriptions must be cancelled before the Google Workspace subscription is suspended.
- If transferring a customer's Google Workspace subscription and an associated
Google-Drive-storage
subscription, use the batch operation. If you transfer each subscription one at a time, the transfer will result in an error. This is especially true since creating a Google Drive subscription creates all of the product's SKUs and, when transferring a Google Drive SKU, all of these SKUs are transferred.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
Google-Drive-storage |
Google Drive storage | Google-Drive-storage-20GB |
Google Drive storage 20 GB |
Google-Drive-storage-50GB |
Google Drive storage 50 GB | ||
Google-Drive-storage-200GB |
Google Drive storage 200 GB | ||
Google-Drive-storage-400GB |
Google Drive storage 400 GB | ||
Google-Drive-storage-1TB |
Google Drive storage 1 TB | ||
Google-Drive-storage-2TB |
Google Drive storage 2 TB | ||
Google-Drive-storage-4TB |
Google Drive storage 4 TB | ||
Google-Drive-storage-8TB |
Google Drive storage 8 TB | ||
Google-Drive-storage-16TB |
Google Drive storage 16 TB |
Google Vault
Google Vault is a service for Google Workspace that lets you retain, archive, search, and export your organization's email for your eDiscovery and compliance needs. It is available as an add-on for G Suite Basic, and is included with G Suite Business and Google Workspace Business Plus, Enterprise Standard, and Enterprise Plus subscriptions. For more information, see the administrator help center.
Things to note for the API's management of a Google Vault subscription:
- Google Vault is available if you, as a reseller, have accepted the amendment to the Terms of Service in your reseller console.
- This subscription is only available as a
monthly post-pay
FLEXIBLE
or 30-day freeTRIAL
plan. The customer must first have an active G Suite Basic subscription. For more information, see the administrator help center.- You can only add Google Vault to an
ACTIVE
status G Suite Basic subscription. Customers must therefore accept Google Workspace terms of services before adding Google Vault. - You can only add Google Vault to a customer with a verified domain.
- You can only add Google Vault to an
- A user is allowed one Google Vault 30-day free trial. This is separate
from a
Google-Apps-For-Business
30-day free trial except in the case of a new Google Vault subscription created during a Google Workspace 30-day free trial plan:- If the G Suite Basic subscription is in a 30-day free trial plan when a Google Vault subscription is created for a user, the Google Vault subscription is in a 30-day free trial plan as well.
- If the G Suite Basic subscription is in a
FLEXIBLE
plan, a Google Vault subscription, previously not in a 30-day free trial, can be in a flexible or 30-day free trial plan.
- Active Google Vault subscriptions must be cancelled before the G Suite Basic subscription can be suspended.
- If transferring a customer's G Suite Basic subscription and an associated Google Vault subscription, use the batch operation. If you transfer each subscription one at a time, the transfer will result in an error.
- The
Google-Vault-Former-Employee
SKU is for Postini customers to manage former employee data. A user assigned this license cannot have any other license assignments. This SKU cannot be purchased, it is only created when an existing Postini customer is migrated. - The
Google-Vault-Former-Employee
SKU must be included when transferring customers that have Postini subscriptions between resellers or changing between direct and resold accounts. This SKU does not allow plan changes.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
Google-Vault |
Google Vault | Google-Vault |
Google Vault |
Google-Vault-Former-Employee |
Google Vault - Former Employee |
Chrome Enterprise
Chrome Enterprise enables administrators to remotely manage their fleet of devices from the cloud. Admins have access to over 200 policies enabling a range of controls covering everything from user and device policies to Chrome App and security features and more.
Things to note for the API's management of a Chrome Enterprise subscription:
- You must apply through Partner Advantage to sell this SKU.
- Chrome Enterprise does not require the user to have an existing Google Workspace subscription.
- This subscription is only compatible with payment plans:
ANNUAL_MONTHLY_PAY
, or 60-day freeTRIAL
. - Customer will not be able to use Chrome Enterprise until their domain is verified.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
Google-Chrome-Device-Management |
Chrome Enterprise | Google-Chrome-Device-Management |
Chrome Enterprise |
Cloud Identity Free Edition
Cloud Identity Free Edition enables administrators to manage their end users without requiring a Google Workspace license. Admins can create users and groups, access audit logs, set up authentication policies such as 2SV (2-Step Verification), and configure SSO (Single Sign-On). Cloud Identity Free Edition also enables basic mobile device management capabilites (enroll devices, set a lock screen, remote wipe).
Things to note for the management of Cloud Identity Free Edition subscriptions:
- Licenses of this SKU will not show for an individual user. This is a site-wide SKU which is applied at the customer level. Learn more about how licensing works in Cloud Identity Free Edition.
- This SKU does not require the customer to have an existing Google Workspace subscription.
- This subscription is only compatible with the
FREE
payment plan and capsmaximumNumberOfSeats
at 50.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
101001 |
Cloud Identity | 1010010001 |
Cloud Identity |
Cloud Identity Premium Edition
Cloud Identity Premium Edition enables administrators to manage their own end users without requiring a Google Workspace license. It supports all features that are offered by Cloud Identity Free Edition. Cloud Identity Premium Edition additionally offers:
- Advanced Device Management features like:
- Control apps installed on user devices
- Enforce passwords and define their strengths
- Enforce security policies
- and many more...
- Auto user provisioning
- First party session management
- 99.9% uptime SLA and 24x7 Email, Phone, Chat and Online support
- and many more. Refer here for details.
Things to note for the management of Cloud Identity Premium Edition subscriptions:
- This SKU does not require the customer to have an existing Google Workspace subscription. However, it can co-exist with existing Google Workspace subscriptions.
- This SKU can be purchased in addition to Cloud Identity Free Edition subscription.
Product ID | Product Name | SKU ID | SKU Name |
---|---|---|---|
101005 |
Cloud Identity Premium | 1010050001 |
Cloud Identity Premium |