如要開始搭配 Java 用戶端程式庫使用 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 用戶端對話方塊中,下載 JSON 檔案 包含用戶端設定用戶端詳細資料包含 包括:
- 用戶端 ID
- 用戶端密碼
這個 JSON 檔案稍後會用來設定 與這個用戶端程式庫搭配使用的 Java 專用 Google 驗證程式庫
在啟動可存取 Library API 的公開應用程式之前, 您的應用程式必須經過 Google 審查。「未驗證的應用程式」訊息會出現在 測試應用程式時的畫面 通過驗證。
設定用戶端程式庫
Java 用戶端程式庫會為您處理所有後端 API 呼叫 方便使用的物件,包括一些常見 API 工作的程式碼範例。 首先,請下載並安裝 Java 適用的 Google Photos Library API 用戶端程式庫 以及 GitHub 的依附元件。 接著,設定 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 檔案。
複製存放區:
如要修改或為這個程式庫提供內容,請使用這個方法 例如提交提取要求,或想試用範例當您 複製存放區,系統會下載這個存放區中的所有檔案。
- 在以下位置執行
git clone https://github.com/google/java-photoslibrary.git
: 使用指令 - 您會取得
java-photoslibrary
目錄。前往該位置:執行cd java-photoslibrary
。 - 在 IDE 中開啟
build.gradle
檔案,或在以下位置執行./gradlew assemble
: 使用命令提示字元建立專案查看「./gradlew tasks
」即可查看 可用的工作。
- 在以下位置執行
設定 Java 的 OAuth2 憑證
此用戶端程式庫可搭配 Google 驗證程式庫 Java。如需更多資訊 請參閱將 OAuth 2.0 與 Google API 用戶端程式庫搭配使用, Java。
出現下列情況時,請在 CredentialsProvider
中指定您的用戶端 OAuth 設定
建立 PhotosLibraryClient
物件的 PhotoLibrarySettings
。
試用一些範例
請嘗試以下程式碼,透過 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
}
更多範例 向您介紹。