Tipos de revendedores
Sua conta foi provisionada como um revendedor direto (nível 1) ou 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, enquanto os distribuidores aparecem 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 do revendedor. Todos os outros recursos têm acesso root.
Você vai precisar do account_id, que fica na página "Configurações" do Partner Sales Console, ao fazer chamadas para a API Cloud Channel.
Clientes
Os clientes, normalmente uma empresa, são os usuários finais dos produtos do Google Cloud para os quais você faz pedidos. Em uma hierarquia do canal de revenda de n camadas, os clientes são os nós de folha.
Direitos
Os direitos representam serviços que são faturados para 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, Google Workspace Business Starter ou Cloud Identity Premium).
Para uma oferta de IaaS como o Google Cloud Platform, um direito seria uma conta de faturamento baseada em consumo que os clientes podem usar nos projetos.
Ofertas
As ofertas representam o que você pode 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 o número de 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
O domínio de revendedor é uma instância do Google Workspace em que é possível 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 aos distribuidores.
Os links de parceiros de canal representam a conexão entre um distribuidor e os revendedores autorizados indiretos. Os distribuidores precisam registrar os parceiros de canal no Google.
Entre em contato com seu gerente de parcerias para mais detalhes sobre esse processo.
Conceitos específicos da API
Identidades do Cloud
Uma identidade da nuvem é o rastro para os clientes do Google Workspace e do Chrome e o conjunto básico de recursos do cliente, incluindo acesso a admin.google.com e gerenciamento de usuários.
Você precisa provisionar uma Cloud Identity com dados específicos do Google Workspace antes de criar um direito 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). Elas são usadas 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 saber o status de uma operação, use o método operations.get.