要求端點

本頁說明您可以用來存取 Cloud Storage 的不同要求端點 (URI)。

一般 API 要求

向任一種 Cloud Storage API 發出要求時,請使用下列 URI:

JSON API

  • 如為物件上傳作業以外的一般 JSON API 要求,請使用下列端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

    https://www.googleapis.com/storage/v1/[PATH_TO_RESOURCE]
  • 如是 JSON API 物件上傳作業,請使用下列端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

    https://www.googleapis.com/upload/storage/v1/b/[BUCKET_NAME]/o
  • 如是批次要求,請使用下列端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

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

JSON API 端點只接受 HTTPS 要求。

XML API

  • 針對所有 XML API 要求,您可以使用下列任一端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

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

如為上傳和下載作業,可以選擇使用 Cloud Storage 提供的專屬 XML API 端點。這些上傳和下載端點在移轉大量資料時能提供一些效能優勢。

  • 針對上傳作業,您可以使用下列任一端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

    https://storage-upload.googleapis.com/[BUCKET_NAME]/[OBJECT_NAME]
    https://[BUCKET_NAME].storage-upload.googleapis.com/[OBJECT_NAME]
  • 針對下載作業,您可以使用下列任一端點,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

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

所有 XML API 端點皆支援安全資料傳輸層 (SSL) 加密。也就是說,您可以使用 HTTP 或 HTTPS。我們建議您使用 HTTPS,尤其是使用 OAuth 2.0 向 Cloud Storage 驗證時,更應該使用 HTTPS。

如為透過 Proxy 進行連線,請參閱疑難排解主題來瞭解推薦的做法。

CNAME 重新導向

CNAME 重新導向是一種特殊的 DNS 記錄,可讓您從自己的網域透過 XML API 使用 URI 存取 Cloud Storage 中的資源,而且不必透露實際的 XML API URI。如要採取這種做法,您必須將下列 URI 加入 記錄的主機名稱部分。

c.storage.googleapis.com.

舉例來說,假設您的網域為 example.com,而且您想讓客戶使用旅遊地圖。您可以在 Cloud Storage 中建立名為 travel-maps.example.com 的值區,然後在 DNS 中建立 CNAME 記錄,將要求從 travel-maps.example.com 重新導向至 Cloud Storage URI。如要完成這項操作,請發布下列 DNS 中的 CNAME 記錄:

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

如此一來,您的客戶就可以使用下列網址存取巴黎的地圖:

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

您應該可以使用網域註冊服務來管理網域,包括新增 CNAME 資源記錄。舉例來說,如果您是使用 Google Domains,則可以在 Google Domains 說明頁面的「Resource records」(資源記錄) 下拉式選單區段中,查看新增資源記錄的操作說明。

經驗證的瀏覽器下載作業

經驗證的瀏覽器下載作業會使用 Cookie 型驗證程序。Cookie 型驗證會要求使用者登入 Google 帳戶來建立身分。指定的 Google 帳戶必須透過身分與存取權管理政策或存取控制清單授予權限來存取資源,才能執行瀏覽器下載作業。

如要使用 Cookie 型驗證下載物件,請使用下列網址,並將 [VALUES_IN_BRACKETS] 替換為適當的值:

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

例如,如果從值區 example-maps 分享圖片 london.jpg,其網址就會是:

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

執行經過驗證的瀏覽器下載作業時,必須使用 HTTPS;嘗試以 HTTP 下載將重新導向至 HTTPS。如需進一步瞭解經驗證的瀏覽器下載作業,請參閱 Cookie 型驗證

存取公開物件

所有向 storage.cloud.google.com URI 發出的要求都必須驗證,即使 allUsers 擁有物件的存取權也是如此。如果您想讓使用者無需經過驗證,即能下載可匿名存取的物件,請使用 直接 API 要求一文中所述的 storage.googleapis.com URI。如需詳細資訊及範例,請參閱存取公開資料

後續步驟

本頁內容對您是否有任何幫助?請提供意見:

傳送您對下列選項的寶貴意見...

這個網頁
Cloud Storage
需要協助嗎?請前往我們的支援網頁