Começar a usar a API CSS

Veja como usar a API CSS:

Permissões

Para trabalhar com a API CSS, configure as permissões em dois lugares: Google Cloud e Central do CSS.

1. Google Cloud IAM:

   • Crie uma conta de serviço no console do Google Cloud. Siga instruções semelhantes às da API Content para criar e baixar o arquivo JSON de credenciais. Esta etapa autentica sua conta de serviço como uma entidade válida do Google Cloud.
   • Se você estiver usando o acesso REST direto ou as bibliotecas de cliente da API do Google, também vai precisar de uma chave de API gerada no Console do Google Cloud.

2. CSS Center:

   • O endereço de e-mail da conta de serviço (por exemplo, [e-mail]) precisa ser adicionado como usuário com acesso de administrador à sua conta do CSS Center. Essa etapa autoriza a conta de serviço a acessar e gerenciar os dados da Central do CSS.
   • É possível conceder acesso no nível do grupo do CSS (para acesso a todos os domínios) ou a contas específicas de domínio do CSS. Para acesso à API, é comum conceder acesso no nível do grupo do CSS.
   • Para adicionar a conta de serviço:
     • Faça login no CSS Center com um usuário administrador.
     • Acesse Acesso à conta (abaixo do ícone de engrenagem ⚙️).
     • Clique em + Adicionar usuário e insira o e-mail da conta de serviço.
     • Defina o nível de acesso como Administrador.
   • A propagação das permissões pode levar até 30 minutos. Se você encontrar erros de permissão, tente de novo mais tarde.

Escopo de autenticação:

O escopo do OAuth 2.0 necessário para a API CSS é:

• https://www.googleapis.com/auth/content

Verifique se o aplicativo solicita esse escopo ao fazer a autenticação.

Ativar a API CSS

Para usar a API CSS, é necessário ativá-la no seu projeto do Google Cloud. Acesse a biblioteca em https://console.cloud.google.com/apis/library/css.googleapis.com.

Começar a programar

A API CSS tem exemplos de código e bibliotecas de cliente para ajudar você a começar. Também temos uma página de práticas recomendadas.

Enviar solicitações

Envie solicitações para URLs no seguinte formato:

https://css.googleapis.com/{version}/{resource name}:{method}…

Em que {resource name} é o nome do recurso afetado pela sua chamada.

Por exemplo, veja como excluir um recurso com gRPC:

https://css.googleapis.com/v1/{resource name}:delete

Veja como excluir um recurso com REST:

DELETE https://css.googleapis.com/v1/{resource name}

Consulte a documentação de referência da API CSS para mais detalhes sobre serviços específicos.

Usar gRPC ou REST

A API CSS é compatível com gRPC e REST. Confira as duas maneiras de fazer chamadas da API CSS:

gRPC (recomendado)	REST
Crie o corpo da solicitação como um buffer de protocolo. Envie o corpo da solicitação para o servidor com HTTP/2. Desserialize a resposta para um buffer de protocolo. Interprete os resultados.	Crie o corpo da solicitação como um objeto JSON. Envie para o servidor usando HTTP 1.1. Desserialize a resposta como um objeto JSON. Interprete os resultados.

Observação: se você usar uma biblioteca de cliente, o mecanismo de transporte padrão será o gRPC. Na maioria dos casos, você não precisa fazer nada além de chamar os endpoints da API CSS para usar o gRPC.

Ajuda

Entre em contato com seu representante do Google para receber suporte ou use o formulário de feedback para informar problemas.

Veja como enviar mais feedback se você tiver problemas:

Enviar feedback

Para enviar feedback, envie uma das seguintes opções:

• Recursos da API:envie o formulário de feedback.
• Documentação:use as classificações com o polegar para cima ou para baixo na página e o botão Enviar feedback.
• Exemplos e bibliotecas:use o botão Novo problema no GitHub.

Para enviar um feedback geral depois de implementar cada tarefa, use o formulário de feedback.