本頁提供存取 Google Health API 的用戶端程式庫範例。
Google Health API 是以 HTTP 和 JSON 做為建構基礎，因此所有標準 HTTP 用戶端都可以向 Google Health API 傳送要求並剖析回應。
不過，您可能想使用這裡提供的用戶端程式庫範例和下載項目，而不手動建立 HTTP 要求及剖析回應。
Java
- 新增 Google API 用戶端程式庫：
- 將程式庫納入專案 (使用 Maven 或 Gradle)。
- 實作 OAuth 2.0 流程：
- 使用
google-auth-library-java處理 OAuth 流程。
- 使用
- 提出 API 要求：
- 使用初始化的用戶端向 Google Health API 發出要求。
import com.google.api.client.auth.oauth2.Credential;
import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow;
import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets;
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.JsonFactory;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.client.util.store.FileDataStoreFactory;
import com.google.api.services.health.v1.Health; // Assuming a generated Google Health API client
import com.google.api.services.health.v1.model.DataResponse; // Example: Response model
import java.io.File;
import java.io.IOException;
import java.io.InputStream;
import java.io.InputStreamReader;
import java.security.GeneralSecurityException;
import java.util.Collections;
import java.util.List;
import java.util.Objects;
import java.util.Scanner;
public class GoogleHealthApiExample {
private static final String CLIENT_SECRETS_PATH = "path/to/your/client_secret.json";
private static final String TOKENS_DIRECTORY_PATH = "tokens";
private static final String API_KEY = "YOUR_API_KEY";
private static final List<String> SCOPES = Collections.singletonList("https://www.googleapis.com/auth/health");
private static final String APPLICATION_NAME = "Google Health API Example";
private static final String DISCOVERY_URL = "https://health.googleapis.com/$discovery/rest"; // Adjust if needed
private static final JsonFactory JSON_FACTORY = new GsonFactory();
private static FileDataStoreFactory dataStoreFactory;
private static HttpTransport httpTransport;
static {
try {
httpTransport = GoogleNetHttpTransport.newTrustedTransport();
dataStoreFactory = new FileDataStoreFactory(new File(TOKENS_DIRECTORY_PATH));
} catch (GeneralSecurityException | IOException e) {
throw new RuntimeException("Error initializing HttpTransport or DataStoreFactory", e);
}
}
public static void main(String[] args) {
try {
Health healthService = createHealthService();
fetchHealthData(healthService);
} catch (Exception e) {
System.err.println("Error during execution: " + e.getMessage());
e.printStackTrace();
}
}
private static Health createHealthService() throws IOException {
Credential credential = getCredentials();
return new Health.Builder(httpTransport, JSON_FACTORY, credential)
.setApplicationName(APPLICATION_NAME)
.setGoogleClientRequestInitializer(request -> {
request.set("key", API_KEY);
})
.setRootUrl(DISCOVERY_URL)
.build();
}
private static Credential getCredentials() throws IOException {
// Load client secrets
InputStream in = Objects.requireNonNull(GoogleHealthApiExample.class.getClassLoader().getResourceAsStream(CLIENT_SECRETS_PATH),
"client_secret.json not found");
GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(JSON_FACTORY, new InputStreamReader(in));
// Build flow and trigger user authorization request.
GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder(
httpTransport, JSON_FACTORY, clientSecrets, SCOPES)
.setDataStoreFactory(dataStoreFactory)
.setAccessType("offline") // Allows for refresh tokens
.build();
Credential credential = flow.loadCredential("user"); // "user" is a key for storing/loading credentials.
if (credential == null || !credential.getAccessToken() != null && credential.getExpiresInSeconds() <= 60) {
// Prompt user to authorize and get new credentials
System.out.println("Please open the following URL in your browser and authorize the app:");
System.out.println(flow.newAuthorizationUrl().setRedirectUri("urn:ietf:wg:oauth:2.0:oob").build());
System.out.print("Enter the authorization code: ");
String code = new Scanner(System.in).nextLine();
credential = flow.createAndStoreCredential(
flow.newTokenRequest(code).setRedirectUri("urn:ietf:wg:oauth:2.0:oob").execute(), "user"
);
}
return credential;
}
private static void fetchHealthData(Health client) throws IOException {
try {
// Example: Replace with actual API method calls
Health.Users.Data.List request = client.users().data().list();
DataResponse response = request.execute();
System.out.println("Health data: " + response);
} catch (Exception e) {
System.err.println("Error fetching health data: " + e.getMessage());
e.printStackTrace();
}
}
}
// Process the response
if (response.statusCode() == 200) {
System.out.println("API Response: " + response.body());
} else {
System.err.println("Error: " + response.statusCode() + " " + response.body());
}
- 匯入程式庫：
com.google.api.client.*：Google API 用戶端的核心程式庫。com.google.api.services.health.*：Google Health API 的產生類別。(您需要根據 API 的導覽文件產生這個檔案)。
- 設定：
CLIENT_SECRETS_PATH：client_secret.json檔案的路徑。TOKENS_DIRECTORY_PATH：儲存權杖的路徑。API_KEY：您的 API 金鑰。SCOPES：必要權限。DISCOVERY_URL：用於取得 API 定義的網址。
main方法：- 初始化 Google Health API 用戶端，並呼叫
fetchHealthData。
- 初始化 Google Health API 用戶端，並呼叫
createHealthService()：- 建立 Google Health API 用戶端例項，並設定憑證、應用程式名稱和 API 金鑰。
getCredentials()：- 從檔案載入用戶端密鑰。
- 建立
GoogleAuthorizationCodeFlow。 - 嘗試載入已儲存的憑證。
- 如果找不到憑證或憑證已過期，系統會提示使用者提供授權碼，並儲存新憑證。
- 傳回憑證物件。
fetchHealthData()：- 向 Google Health API 發出 API 呼叫 (請將範例替換為您的特定方法呼叫)。
- 列印回覆。
- 錯誤處理：程式碼包含用於錯誤處理的基本
try...catch區塊。
JavaScript
- 安裝 Google API 用戶端程式庫：
- 將程式庫納入專案。您可以使用 CDN 或 npm。
- 實作 OAuth 2.0 流程：
- 使用 Google Identity 服務程式庫處理 OAuth 流程 (結果 16.1)。
- 提出 API 要求：
- 使用初始化的用戶端向 Google Health API 發出要求。
import { google } from 'https://apis.google.com/js/api.js';
import { GoogleIdentityServices } from 'https://accounts.google.com/gsi/client';
const CLIENT_ID = 'YOUR_CLIENT_ID';
const API_KEY = 'YOUR_API_KEY';
const DISCOVERY_URL = 'https://health.googleapis.com/$discovery/rest'; // Replace with actual discovery URL if needed
const SCOPES = 'https://www.googleapis.com/auth/health'; // Add other scopes as needed
let tokenClient;
async function initClient() {
await new Promise((resolve, reject) => {
google.load('client', { callback: resolve, onerror: reject });
});
await google.client.init({
apiKey: API_KEY,
discoveryDocs: [DISCOVERY_URL],
});
tokenClient = await new Promise((resolve, reject) => {
const client = GoogleIdentityServices.oauth2.initTokenClient({
client_id: CLIENT_ID,
scope: SCOPES,
callback: (response) => {
if (response && response.access_token) {
resolve(response.access_token);
} else {
reject(new Error('Failed to get token'));
}
},
error_callback: (error) => {
reject(error);
},
});
resolve(client);
});
console.log("Client initialized");
await authorize();
}
async function authorize() {
if (google.client.getToken()) {
console.log("Already authorized");
return;
}
return await new Promise((resolve, reject) => {
if(tokenClient){
tokenClient.requestAccessToken();
resolve();
}
else {
reject(new Error('Token client not initialized'));
}
});
}
async function fetchHealthData() {
try{
await authorize();
// Example: Replace with actual API method calls
const response = await google.client.health.users.data.list();
console.log('Health data:', response.result);
} catch (error) {
console.error('Error fetching data:', error);
}
}
initClient().then(() => {
fetchHealthData();
});
- 匯入程式庫：
https://apis.google.com/js/api.js：載入核心 Google API 用戶端。https://accounts.google.com/gsi/client：載入 Google Identity 服務以進行驗證。
- 設定：
CLIENT_ID、API_KEY：請替換為實際憑證。DISCOVERY_URL：取得 API 定義的網址。您可能需要根據最終的 Google Health API 設定調整這項設定。SCOPES：定義應用程式所需的必要權限 (例如讀取健康資料)。
initClient()：- 載入 Google API 用戶端。
- 使用 API 金鑰和導覽文件初始化用戶端。
- 初始化 Google Identity 服務權杖用戶端。
authorize()：- 檢查是否已有權杖。
- 如果沒有，則會呼叫
tokenClient.requestAccessToken()來啟動 OAuth 流程。
fetchHealthData()：- 呼叫
authorize()，確保使用者已通過驗證。 - 向 Google Health API 發出 API 呼叫 (請將範例替換成您的特定呼叫)。
- 記錄回應。
- 呼叫
- 錯誤處理：程式碼包含用於錯誤處理的基本
try...catch區塊。
Python
- 安裝 Google API 用戶端程式庫：
- 使用
pip安裝必要的程式庫。
- 使用
- 實作 OAuth 2.0 流程：
- 使用
google-auth-oauthlib程式庫處理 OAuth 流程。
- 使用
- 提出 API 要求：
- 使用初始化的用戶端向 Google Health API 發出要求。
import google.auth
from google.auth.transport.requests import Request
from google.oauth2.credentials import Credentials
from google_auth_oauthlib.flow import InstalledAppFlow
import googleapiclient.discovery
import os
import json
# --- REPLACE WITH YOUR VALUES ---
CLIENT_SECRETS_FILE = 'path/to/your/client_secret.json'
API_KEY = 'YOUR_API_KEY'
SCOPES = ['https://www.googleapis.com/auth/health'] # Add other scopes as needed
DISCOVERY_URL = 'https://health.googleapis.com/$discovery/rest' # Adjust if needed
TOKEN_FILE = 'token.json'
def get_credentials():
"""Gets or creates OAuth 2.0 credentials."""
creds = None
# The file token.json stores the user's access and refresh tokens, and is
# created automatically when the authorization flow completes for the first
# time.
if os.path.exists(TOKEN_FILE):
with open(TOKEN_FILE, 'r') as token:
creds = Credentials.from_authorized_user_info(json.load(token), SCOPES)
# If there are no (valid) credentials available, let the user log in.
if not creds or not creds.valid:
if creds and creds.expired and creds.refresh_token:
creds.refresh(Request())
else:
flow = InstalledAppFlow.from_client_secrets_file(
CLIENT_SECRETS_FILE, SCOPES
)
creds = flow.run_local_server(port=0)
# Save the credentials for the next run
with open(TOKEN_FILE, 'w') as token:
token.write(creds.to_json())
return creds
def create_health_client(creds):
"""Creates a Google Health API client."""
return googleapiclient.discovery.build(
'health',
'v1', # Replace with the actual API version if needed
credentials=creds,
discoveryServiceUrl=DISCOVERY_URL,
developerKey=API_KEY
)
def fetch_health_data(client):
"""Fetches health data using the API client."""
try:
# Example: Replace with actual API method calls
response = client.users().data().list().execute()
print('Health data:', response)
except Exception as e:
print(f'Error fetching data: {e}')
if __name__ == '__main__':
try:
creds = get_credentials()
health_client = create_health_client(creds)
fetch_health_data(health_client)
except Exception as e:
print(f"An error occurred: {e}")