自 2025 年 3 月 27 日起，我們建議您使用 android-latest-release 而非 aosp-main 建構及貢獻 AOSP。詳情請參閱「Android 開放原始碼計畫變更」。

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

GoogleApiClientUtil

public class GoogleApiClientUtil
extends Object

java.lang.Object
↳	com.android.tradefed.util.GoogleApiClientUtil

建立 Google API 用戶端的公用程式。

摘要

欄位
`public static final String`	`APP_NAME`

公用建構函式
`GoogleApiClientUtil()`

公用方法
`static HttpRequestInitializer`	`configureRetryStrategy(HttpRequestInitializer initializer)` 為提供的 HttpRequestInitializer 設定重試策略。
`static Credential`	`createCredential( scopes, Boolean useCredentialFactory, File primaryKeyFile, String hostOptionKeyFileName, File... backupKeyFiles)` 請嘗試使用其他金鑰檔案或本機主機建立憑證。
`static Credential`	`createCredential( scopes, File primaryKeyFile, String hostOptionKeyFileName, File... backupKeyFiles)` 請嘗試使用其他金鑰檔案或本機主機建立憑證。
`static Credential`	`createCredentialFromJsonKeyFile(File file, scopes)` 透過 JSON 金鑰檔案建立憑證。
`static Credential`	`createCredentialFromP12File(String serviceAccount, File keyFile, scopes)` 此方法已淘汰。由於 Google App Engine 已淘汰 p12，因此建議使用 JSON 金鑰檔案。 JSON 金鑰檔案包含更多資訊。
`static HttpRequestInitializer`	`setHttpTimeout(HttpRequestInitializer requestInitializer, int connectTimeout, int readTimeout)`

欄位

APP_NAME

public static final String APP_NAME

公用建構函式

GoogleApiClientUtil

public GoogleApiClientUtil ()

公用方法

設定重試策略

public static HttpRequestInitializer configureRetryStrategy (HttpRequestInitializer initializer)

為提供的 HttpRequestInitializer 設定重試策略。如果發生伺服器錯誤系統會以指數輪詢方式自動重試要求。

參數
`initializer`	`HttpRequestInitializer`：- 設定重試策略的初始化器。

傳回
`HttpRequestInitializer`	可自動重試失敗要求的初始化器。

建立憑證

public static Credential createCredential ( scopes, 
                Boolean useCredentialFactory, 
                File primaryKeyFile, 
                String hostOptionKeyFileName, 
                File... backupKeyFiles)

請嘗試使用其他金鑰檔案或本機主機建立憑證。

1. 如果 useCredentialFactory 為 true，且已設定 ICredentialFactory，請使用 ICredentialFactory。如果已設定 primaryKeyFile，請嘗試使用該金鑰建立憑證2. 請嘗試從「HostOptions」取得對應的金鑰檔案。3. 嘗試使用備份金鑰檔案4. 使用本機預設憑證。

參數
`scopes`	：憑證的範圍。
`useCredentialFactory`	`Boolean`：使用已設定的憑證工廠 (如果已設定)，
`primaryKeyFile`	`File`：主要 JSON 金鑰檔案；可以是空值
`hostOptionKeyFileName`	`String`：`HostOptions`「service-account-json-key-file」選項的金鑰；可以是空值
`backupKeyFiles`	`File`：備用金鑰檔案。

傳回
`Credential`	`Credential`

擲回
	IOException

建立憑證

public static Credential createCredential ( scopes, 
                File primaryKeyFile, 
                String hostOptionKeyFileName, 
                File... backupKeyFiles)

請嘗試使用其他金鑰檔案或本機主機建立憑證。

1. 如果已設定 primaryKeyFile，請嘗試使用該金鑰建立憑證。2. 試著取得來自 HostOptions 的對應金鑰檔案。3. 嘗試使用備用金鑰檔案。4. 使用本機預設憑證

參數
`scopes`	：憑證的範圍。
`primaryKeyFile`	`File`：主要 JSON 金鑰檔案；可以是空值
`hostOptionKeyFileName`	`String`：`HostOptions`「service-account-json-key-file」選項的金鑰；可以是空值
`backupKeyFiles`	`File`：備用金鑰檔案。

傳回
`Credential`	`Credential`

擲回
	IOException

createCredentialFromJsonKeyFile

public static Credential createCredentialFromJsonKeyFile (File file, 
                 scopes)

透過 JSON 金鑰檔案建立憑證。

參數
`file`	`File`：是 p12 金鑰檔案
`scopes`	：是 API 的範圍。

傳回
`Credential`	`Credential`。

擲回
	FileNotFoundException
	IOException

createCredentialFromP12File

public static Credential createCredentialFromP12File (String serviceAccount, 
                File keyFile, 
                 scopes)

此方法已淘汰。
由於 Google App Engine 已淘汰 p12，因此建議使用 JSON 金鑰檔案。 JSON 金鑰檔案包含更多資訊。

從服務帳戶的 p12 檔案中建立憑證。

參數
`serviceAccount`	`String`：這是服務帳戶
`keyFile`	`File`：是 p12 金鑰檔案
`scopes`	：是 API 的範圍。

傳回
`Credential`	`Credential`。

擲回
	一般安全性例外狀況

setHttpTimeout

public static HttpRequestInitializer setHttpTimeout (HttpRequestInitializer requestInitializer, 
                int connectTimeout, 
                int readTimeout)

參數
`requestInitializer`	`HttpRequestInitializer`：`HttpRequestInitializer`，通常為 `Credential`。
`connectTimeout`	`int`：連線逾時 (以毫秒為單位)。
`readTimeout`	`int`：讀取逾時，以毫秒為單位。

傳回
`HttpRequestInitializer`	逾時的 `HttpRequestInitializer`。