本頁面由 Cloud Translation API 翻譯而成。

開始使用 Java 用戶端程式庫

如要開始透過 Java 用戶端程式庫使用 Google Photos Library API，您必須在開發環境中設定用戶端程式庫。開始之前，請先透過 Google API 控制台啟用 API，並設定 OAuth 2.0 用戶端 ID，以設定專案。

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

OAuth 2.0 用戶端 ID 可讓應用程式使用者登入、驗證，然後再使用 Library API。Library API 不支援服務帳戶；如要使用這個 API，使用者必須登入有效的 Google 帳戶。

設定應用程式

啟用 API

您必須先為專案啟用 Library API，才能使用該程式庫。

前往 Google API 控制台。
在選單列中，選取專案或建立新專案。
如要開啟 Google API 程式庫，請在導覽選單中依序選取「API 和服務」>「程式庫」。
搜尋「Google Photos Library API」。選取正確的結果，然後按一下「啟用」。

要求 OAuth 2.0 用戶端 ID

請按照下列步驟，要求取得 OAuth 用戶端 ID，並為您的應用程式設定該 ID。這個範例使用的應用程式在伺服器端處理整個 OAuth 流程，就如我們的範例中所示。設定程序可能因其他導入情境而異。

前往 Google API 控制台，然後選取您的專案。
在選單中依序選取「API 和服務」>「憑證」。
在「憑證」頁面上，按一下「建立憑證」>「OAuth 用戶端 ID」。
選取您的「應用程式類型」。在這個範例中，應用程式類型為網頁應用程式。
按照下列方式註冊應用程式可存取 Google API 的來源：
1. 若要識別用戶端 ID，請輸入名稱。
2. 在「Authorized JavaScript origins」(已授權的 JavaScript 來源) 欄位，輸入應用程式來源。這個欄位不允許使用萬用字元。
  
  您可以輸入多個來源，讓應用程式在不同的通訊協定、網域或子網域上執行。您輸入的網址可發出 OAuth 要求。
  
  以下範例是本機開發網址 (我們的範例使用 localhost:8080) 和實際工作環境網址。
```
http://localhost:8080
https://myproductionurl.example.com
```
3. 「已授權的重新導向 URI」欄位是接收 OAuth 2.0 伺服器回應的端點。通常，這包括您的開發環境，並指向應用程式中的路徑。
```
http://localhost:8080/auth/google/callback
https://myproductionurl.example.com/auth/google/callback
```
4. 點選「建立」。

從產生的 OAuth 用戶端對話方塊中，下載包含用戶端設定的 JSON 檔案。用戶端詳細資料包含下列內容：
- 用戶端 ID
- 用戶端密碼
這個 JSON 檔案稍後將用來設定適用於這個用戶端程式庫的 Java 適用的 Google 驗證程式庫。

您的應用程式必須通過 Google 審查，才能發布用於存取 Library API 的公開應用程式。測試應用程式時，畫面上會顯示「未驗證的應用程式」訊息，直到應用程式通過驗證為止。

設定用戶端程式庫

Java 用戶端程式庫會為您處理所有後端 API 呼叫，並提供適合使用的物件，包括一些常見 API 工作的程式碼範例。首先，請前往 GitHub 下載並安裝 Java 適用的 Google Photos Library API 用戶端程式庫與依附元件。接著，設定 Java 專用的 OAuth2 憑證。

下載選項

下載用戶端程式庫的選項如下：

Gradle 依附元件：

如要搭配 Gradle 使用這個程式庫，請在 build.gradle 檔案中新增以下依附元件。

repositories {
  mavenCentral()
}
dependencies {
  compile 'com.google.photos.library:google-photos-library-client:1.7.3'
}

Maven 依附元件：

如要搭配 Maven 使用這個程式庫，請將以下內容新增至 Maven pom.xml 檔案。

<dependency>
  <groupId>com.google.photos.library</groupId>
  <artifactId>google-photos-library-client</artifactId>
  <version>1.7.3</version>
</dependency>

下載版本：

版本頁面包含每個程式庫版本的不同構件，包括 jar 檔案。
複製存放區：

如要修改或提供這個程式庫，例如提交提取要求，或是想要試用範例，請使用這個方法。複製存放區時，系統會下載這個存放區中的所有檔案。
1. 在命令提示字元中執行 git clone https://github.com/google/java-photoslibrary.git。
2. 您會取得 java-photoslibrary 目錄。執行 cd java-photoslibrary 即可導覽至該介面。
3. 在 IDE 中開啟 build.gradle 檔案，或是在命令提示字元中執行 ./gradlew assemble 以建構專案。如要查看可用的工作，請參閱 ./gradlew tasks。

為 Java 設定 OAuth2 憑證

這個用戶端程式庫可與 Java 適用的 Google 驗證程式庫搭配使用。詳情請參閱「將 OAuth 2.0 與 Java 適用的 Google API 用戶端程式庫搭配使用」一文。

為 PhotosLibraryClient 物件建立 PhotoLibrarySettings 時，請在 CredentialsProvider 中指定用戶端 OAuth 設定。

試用範例

請嘗試使用下列程式碼，透過 Java 用戶端程式庫進行第一次 API 呼叫。

// Set up the Photos Library Client that interacts with the API
PhotosLibrarySettings settings =
     PhotosLibrarySettings.newBuilder()
    .setCredentialsProvider(
        FixedCredentialsProvider.create(/* Add credentials here. */)) 
    .build();

try (PhotosLibraryClient photosLibraryClient =
    PhotosLibraryClient.initialize(settings)) {

    // Create a new Album  with at title
    Album createdAlbum = photosLibraryClient.createAlbum("My Album");

    // Get some properties from the album, such as its ID and product URL
    String id = album.getId();
    String url = album.getProductUrl();

} catch (ApiException e) {
    // Error during album creation
}

GitHub 上還有更多範例可供試用。