您目前查看的是 Google Photos Library API 的舊版說明文件。
開始使用 REST
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
如要開始使用 Google Photos Library API,請透過下列方法啟用 API 以設定專案:
並設定 OAuth 2.0 用戶端 ID。
您的應用程式代表
Google 相簿使用者。例如,當您在使用者的
Google 相簿相片庫或將媒體項目上傳到使用者的
Google 相簿帳戶,使用者透過
OAuth 2.0 通訊協定。
OAuth 2.0 用戶端 ID 可讓應用程式使用者登入、驗證
然後使用 Library APILibrary API 不支援
或服務帳戶如要使用這個 API,使用者必須登入有效的 Google
。
啟用 API
您必須先為專案啟用 Library API,才能使用該 API。
- 前往 Google API 控制台。
- 在選單列中,選取專案或建立新專案。
- 如要開啟 Google API 程式庫,請從導覽選單選取
API 與服務 >程式庫。
- 搜尋「Google Photos Library API」。選取正確的結果並按一下
啟用:
要求 OAuth 2.0 用戶端 ID
請按照下列步驟申請 OAuth 用戶端 ID,並為其進行設定
應用程式。這個範例使用的應用程式,其可存取整個 OAuth 流程
,如我們範例中所示設定程序可能不同
其他導入情境。
- 前往 Google API 控制台
然後選取所需專案
- 從選單中選取「API 與」服務 >憑證。
- 在「Credentials」(憑證) 頁面上,按一下「Create Credentials」(建立憑證) > OAuth 用戶端 ID。
- 選取您的「應用程式類型」。在這個範例中,應用程式類型為
網頁應用程式。
註冊應用程式可存取 Google API 的來源
如下所示:
- 為識別用戶端 ID,請輸入名稱。
在「授權的 JavaScript 來源」欄位中,輸入
應用程式。這個欄位不允許使用萬用字元。
您可以輸入多個來源,讓應用程式在不同的位置執行
通訊協定、網域或子網域您輸入的網址可以
開始 OAuth 要求。
以下範例是本機開發網址 (我們的範例使用
localhost:8080
) 和正式版網址。
http://localhost:8080
https://myproductionurl.example.com
「授權的重新導向 URI」欄位是接收到的端點
OAuth 2.0 伺服器的回應。通常這包括
並指向應用程式中的路徑
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
按一下「建立」。
-
從產生的 OAuth 用戶端對話方塊中,複製以下內容:
您的應用程式可以使用這些值存取已啟用的 Google API。
在啟動可存取 Library API 的公開應用程式之前,
您的應用程式必須經過 Google 審查。「未驗證的應用程式」訊息會出現在
測試應用程式時的畫面
通過驗證。
試用範例
現在您已設定專案,搭配 Library API 使用,
查看 GitHub 上的範例應用程式。範例應用程式
示範如何使用 Library API 打造智慧型相框模式。
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-08-29 (世界標準時間)。
[null,null,["上次更新時間:2025-08-29 (世界標準時間)。"],[[["\u003cp\u003eTo use the Google Photos Library API, you must enable the API and set up an OAuth 2.0 client ID through the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eUsers must be signed in to a valid Google Account to use the Library API as it requires user authorization via OAuth 2.0 for actions like creating albums or uploading media.\u003c/p\u003e\n"],["\u003cp\u003eBefore launching publicly, your application needs to be reviewed and verified by Google to remove the "Unverified app" message during testing.\u003c/p\u003e\n"]]],["To utilize the Google Photos Library API, first enable it for your project in the Google API Console. Then, create an OAuth 2.0 client ID, specifying the application type, authorized JavaScript origins, and redirect URIs. Obtain the client ID and secret from the resulting dialog. Ensure your application is reviewed by Google before public launch. Note, only valid Google Account users can use this API as service accounts aren't supported.\n"],null,["# Get started with REST\n\nTo start using the Google Photos Library API, configure your project by enabling the API via\nthe Google API Console and setting up an OAuth 2.0 client ID.\n\nYour application interacts with Google Photos on behalf of a\nGoogle Photos user. For instance, when you create albums in a user's\nGoogle Photos library or upload media items to a user's\nGoogle Photos account, the user authorizes these API requests via the\n[OAuth 2.0](/identity/protocols/OAuth2) protocol.\n\nThe OAuth 2.0 client ID allows your application users to sign in, authenticate,\nand thereby use the Library API. The Library API does not support\nservice accounts; to use this API, users must be signed in to a valid Google\nAccount.\n\nConfigure your app\n------------------\n\n### Enable the API\n\nBefore you can use the Library API, you must enable it for your project.\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library).\n2. From the menu bar, select a project or create a new project.\n3. To open the Google API Library, from the Navigation menu, select **APIs \\& Services \\\u003e Library**.\n4. Search for \"Google Photos Library API\". Select the correct result and click **Enable**.\n\n### Request an OAuth 2.0 client ID\n\nFollow the steps below to request an OAuth client ID and configure it for your\napplication. This example uses an application where the entire OAuth flow is\nhandled server-side, such as the one in our samples. The setup process may vary\nfor other [implementation scenarios](/identity/protocols/OAuth2).\n\n1. Go to the [Google API Console](https://console.developers.google.com/apis/library) and select your project.\n2. From the menu, select **APIs \\& Services \\\u003e Credentials**.\n3. On the **Credentials** page, click **Create Credentials \\\u003e OAuth client ID**.\n4. Select your **Application type** . In this example, the application type is **Web application**.\n5. Register the origins from which your app is allowed to access the Google APIs\n as follows:\n\n 1. To identify the client ID, enter a name.\n 2. In the **Authorized JavaScript origins** field, enter the origin for your\n app. This field doesn't allow wildcards.\n\n You can enter multiple origins to allow your app to run on different\n protocols, domains, or subdomains. The URLs you enter are allowed to\n start an OAuth request.\n\n The following example shows a local development URL (our samples use\n `localhost:8080`) and a production URL. \n\n http://localhost:8080\n https://myproductionurl.example.com\n\n 3. The **Authorized redirect URI** field is the endpoint that receives\n responses from the OAuth 2.0 server. Typically, this includes your\n development environment and points to a path in your application.\n\n http://localhost:8080/auth/google/callback\n https://myproductionurl.example.com/auth/google/callback\n\n 4. Click **Create**.\n\n\u003c!-- --\u003e\n\n6. From the resulting OAuth client dialog, copy the following:\n\n - Client ID\n - Client secret\n\n Your app can access the enabled Google APIs using these values.\n\nBefore you can launch a public application that accesses the Library API,\nyour app must be reviewed by Google. An \"Unverified app\" message appears on the\nscreen when you test your application, until it is\n[verified](https://support.google.com/cloud/answer/7454865).\n\nTry out the sample\n------------------\n\nNow that you've configured your project for use with the Library API,\ncheck out the [sample app](/photos/library/samples) on GitHub. The sample app\ndemonstrates how you can build a smart photo frame using the Library API."]]