設定應用程式

如要開始使用 Google 相簿 API，請使用 Google API 控制台啟用所需的 Google 相簿 API，並設定 OAuth 2.0 用戶端 ID，藉此設定專案。

您的應用程式會代表 Google 相簿使用者與 Google 相簿互動。舉例來說，當您在使用者的 Google 相簿中建立相簿，或將媒體項目上傳至使用者的 Google 相簿帳戶時，使用者會使用 OAuth 2.0 通訊協定授權這些 API 要求。

OAuth 2.0 用戶端 ID 可讓應用程式使用者登入、驗證，並使用 Photos API。相片 API 不支援服務帳戶；使用者必須登入有效的 Google 帳戶，才能使用這些 API。

設定應用程式

請先啟用 API，然後要求 OAuth 2.0 用戶端 ID。

啟用 API

您必須先在專案中啟用相片 API，才能使用這些 API。

  1. 前往 Google API 控制台。
  2. 在選單列中選取專案或建立新專案。
  3. 如要開啟其中一個 Google Photos API，請在導覽選單中依序選取「APIs & Services」(API 和服務) >「Library」(程式庫)。
  4. 搜尋「相片」。選取一或多個 Google 相簿 API，然後按一下「啟用」。

Google Cloud 控制台中的 Picker API 螢幕截圖

要求 OAuth 2.0 用戶端 ID

請按照以下步驟要求 OAuth 用戶端 ID，並為您的應用程式設定這個 ID。這個範例會使用整個 OAuth 流程皆由伺服器端處理的應用程式，例如範例中的應用程式。其他導入情境的設定程序可能會有所不同。

  1. 前往 Google API 控制台，然後選取您的專案。
  2. 在選單中，依序選取「API 和服務」>「憑證」。

  3. 在「憑證」頁面上，依序點選「建立憑證」>「OAuth 用戶端 ID」。

  4. 選取「應用程式類型」。在這個範例中，應用程式類型為「Web application」。

  5. 請按照下列步驟，註冊應用程式可存取 Google API 的來源：

    1. 為識別用戶端 ID，請輸入名稱。

    2. 在「授權的 JavaScript 來源」欄位中輸入應用程式的來源。這個欄位不支援萬用字元。

      您可以輸入多個來源，讓應用程式在不同的通訊協定、網域或子網域上執行。您輸入的網址可用於啟動 OAuth 要求。

      以下範例顯示本機開發網址 (我們的範例使用 localhost:8080) 和正式網址。

      http://localhost:8080
https://myproductionurl.example.com

    3. 「Authorized redirect URI」欄位是接收 OAuth 2.0 伺服器回應的端點。通常包括開發環境，並指向應用程式中的路徑。

      http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback

    4. 按一下「建立」。

  1. 從產生的 OAuth 用戶端對話方塊中，複製以下內容：

    • 用戶端 ID
    • 用戶端密碼

    應用程式可以使用這些值存取已啟用的 Google API。

您必須先讓 Google 審查應用程式，才能推出可存取 Google 相簿 API 的公開應用程式。在您測試應用程式之前，畫面上會顯示「未驗證的應用程式」訊息，直到應用程式通過驗證為止。

設定應用程式後，即可開始使用：

變更用戶端 ID

透過任何 Google Photos API 建立的資源，只能使用當初用來建立資源的原始用戶端 ID，來存取或修改資源。例如，如果您在 Picker API 中使用特定用戶端 ID 建立「工作階段」，之後又在應用程式中變更該用戶端 ID，應用程式將無法存取透過先前用戶端 ID 建立的任何 API 資源。

請仔細規劃，並為所使用的 Google 相簿 API 選擇正確的用戶端 ID 類型。只有在絕對必要的情況下，才可以變更用戶端 ID，以免發生存取問題。