Tipos de revendedores
Sua conta foi provisionada como um revendedor direto
(1 nível) ou um distribuidor (2 níveis). Você pode confirmar o tipo de conta na
página "Configurações" do Partner Sales Console. Os revendedores diretos aparecem como
RESELLER, e os distribuidores como DISTRIBUTOR.
Conceitos gerais do Channel Services
Figura 1. Diagrama da relação entre os conceitos do Channel Services apresentados neste documento.
Contas
Uma conta é a entidade de nível superior e é mapeada para seu
domínio de revendedor. Todos os outros recursos estão enraizados abaixo dele.
Você vai precisar do account_id, encontrado na página "Configurações" do
Partner Sales Console, ao fazer chamadas para a API Cloud Channel.
Clientes
Os clientes, geralmente uma empresa, são os usuários finais dos produtos do Google Cloud para os quais você faz pedidos. Em uma hierarquia de canal de revenda de vários níveis, os clientes são os nós de folha.
Direitos
Os direitos representam serviços que são cobrados de você, mas usados por um dos seus clientes.
Para uma oferta de SaaS, como o Google Workspace, um direito seria uma assinatura de um dos serviços (por exemplo, o Google Workspace Business Starter ou o Cloud Identity Premium).
Para uma oferta de IaaS, como o Google Cloud Platform, um direito de acesso é uma conta de faturamento baseada no consumo que os clientes podem usar nos projetos.
Ofertas
As ofertas representam o que você tem permissão para vender. Uma oferta e um cliente são os principais componentes de um direito.
As ofertas são uma combinação de uma SKU e um modelo de preços. Por exemplo, um único produto com vários planos de pagamento ou níveis de desconto teria tantas ofertas quanto as permutações do produto e dos planos ou descontos.
No Google Workspace, as ofertas não mudam o preço. Quando os preços mudam, novos
offerIds são gerados.
Domínio do revendedor
Um domínio de revendedor é uma instância do Google Workspace em que você pode gerenciar os privilégios de acesso ao Partner Sales Console.
Links de parceiros de canal
Os links de parceiros de canal são aplicáveis apenas a distribuidores.
As vinculações de parceiros de canal representam a conexão entre um distribuidor e os revendedores indiretos autorizados. Os distribuidores precisam registrar os parceiros de canal no Google.
Entre em contato com seu gerente de parcerias para saber mais sobre esse processo.
Conceitos específicos da API
Identidades do Cloud
Uma identidade do Cloud é a pegada ecológica dos clientes do Google Workspace e do Chrome, além do conjunto básico de recursos do cliente, incluindo acesso a admin.google.com e gerenciamento de usuários.
É necessário provisionar uma identidade do Cloud com dados específicos do Google Workspace antes de criar um direito de acesso para um produto do Google Workspace ou do Chrome.
Operações
As operações também são chamadas de operações de longa duração (LRO, na sigla em inglês). Eles são usados em toda a API Cloud Channel, já que muitas ações acionadas por chamadas de API não são instantâneas e podem levar mais tempo do que os tempos limite padrão do cliente.
As operações são chamadas de API assíncronas. Os endpoints que usam operações
podem retornar erros HTTP 4xx (devido à validação síncrona) ou um
código HTTP 200 com um recurso Operation e o identificador da operação.
Para conferir o status de uma operação, use o método operations.get.