Esta página foi traduzida pela API Cloud Translation.

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.

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.
CSS Center:
- O endereço de e-mail da conta de serviço (por exemplo, your-service-account-name@your-project-id.iam.gserviceaccount.com) 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 é:

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

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.

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.

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.

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.

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:

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.