Endpoints de solicitação

Nesta página, você conhecerá os diferentes endpoints de solicitação (URIs) que podem ser usados para acessar o Cloud Storage.

Solicitações típicas de API

Use os seguintes URIs para fazer solicitações diretamente a uma das APIs do Cloud Storage:

API JSON

  • Para solicitações gerais da API JSON, exceto uploads de objetos, use o endpoint a seguir, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://www.googleapis.com/storage/v1/[PATH_TO_RESOURCE]
  • Use o ponto de extremidade a seguir para uploads de objeto da API JSON, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://www.googleapis.com/upload/storage/v1/b/[BUCKET_NAME]/o
  • Use o endpoint a seguir para solicitações em lote, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://www.googleapis.com/batch/storage/v1/[PATH_TO_RESOURCE]

Os pontos de extremidade da API JSON aceitam somente solicitações HTTPS.

API XML

  • Para todas as solicitações da API XML, é possível usar um dos endpoints a seguir, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://storage.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage.googleapis.com/[OBJECT_NAME]

Outra opção para uploads e downloads é usar os pontos de extremidade dedicados para a API XML do Cloud Storage. Esses pontos de extremidade de upload e download podem melhorar um pouco o desempenho quando estiverem sendo transferidas grandes quantidades de dados.

  • Para uploads, é possível usar um dos pontos de extremidade a seguir, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://storage-upload.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage-upload.googleapis.com/[OBJECT_NAME]
  • Para downloads, é possível usar um dos pontos de extremidade a seguir, substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

    https://storage-download.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage-download.googleapis.com/[OBJECT_NAME]

Todos os pontos de extremidade da API XML são compatíveis com criptografia SSL (Secure Sockets Layer), o que significa que você pode usar HTTP ou HTTPS. Recomendamos o uso de HTTPS, especialmente se a autenticação no Cloud Storage for feita usando o OAuth 2.0.

Para conexões por proxy, consulte o tópico Solução de problemas para conhecer as práticas recomendadas.

Redirecionamentos CNAME

Um redirecionamento CNAME é um registro DNS especial que permite usar URIs do seu próprio domínio para acessar recursos no Cloud Storage por meio da API XML, sem revelar os URIs reais da API XML. Para isso, adicione o seguinte URI ao nome do host do registro CNAME :

c.storage.googleapis.com.

Por exemplo, digamos que seu domínio seja example.com e você queira disponibilizar mapas de viagens para seus clientes. Você pode criar um intervalo no Cloud Storage chamado travel-maps.example.com e, em seguida, criar um registro CNAME no DNS que redirecione as solicitações de travel-maps.example.com para o URI do Cloud Storage. Para isso, insira o seguinte registro CNAME no DNS:

NAME                      TYPE     DATA
travel-maps.example.com   CNAME    c.storage.googleapis.com.

Com isso, seus clientes podem usar este URL para acessar um mapa de Paris:

http://travel-maps.example.com/paris.jpg

O serviço de registro de domínio precisa ter como administrar seu domínio, incluindo adicionar um registro de recurso CNAME. Por exemplo, no Google Domains, as instruções para adicionar um registro de recurso estão na página de Ajuda do Google Domains, na seção suspensa Registros de recurso.

Downloads por navegadores autenticados

Os downloads por navegador autenticado usam autenticação baseada em cookies. A autenticação baseada em cookies solicita que os usuários façam login nas respectivas Contas do Google para definir a identidade. Para realizar o download pelo navegador, a Conta do Google especificada precisa ter a permissão adequada para acessar o recurso, que é concedida por meio de políticas do IAM ou de listas de controle de acesso.

Para fazer o download de um objeto usando a autenticação baseada em cookie, use o URL a seguir substituindo [VALUES_IN_BRACKETS] pelos valores adequados:

https://storage.cloud.google.com/[BUCKET_NAME]/[OBJECT_NAME]

Por exemplo, se você compartilhou uma imagem london.jpg do intervalo example-maps, o URL será:

https://storage.cloud.google.com/example-maps/london.jpg

O uso de HTTPS é altamente recomendado para executar downloads por navegador autenticado. No entanto, HTTP também é compatível. Para mais informações sobre downloads em navegador autenticado, consulte Autenticação baseada em cookies.

Acesso a objetos públicos

Observação: todas as solicitações para o URI storage.cloud.google.com exigem autenticação, até mesmo quando allUsers têm permissão para acessar um objeto. Caso queira que os usuários façam o download de objetos acessíveis anonimamente sem autenticação, use o URI storage.googleapis.com documentado nas solicitações diretas de API. Para detalhes e exemplos, consulte Como acessar dados públicos.

A seguir

Esta página foi útil? Conte sua opinião sobre:

Enviar comentários sobre…

Precisa de ajuda? Acesse nossa página de suporte.