Method: devices.create

ユーザーの Google フォト アカウントにアンビエント デバイスを作成します。

指定された requestId を持つデバイスがすでに存在する場合は、ALREADY_EXISTS エラーが返されます。デバイスの重複を防ぐには、次の操作を行います。

  • 既存のデバイスの deviceId がわかっている場合は、devices.get を呼び出して取得します。
  • deviceId がわからない場合は、requestId を指定して devices.delete を呼び出して孤立したデバイスを削除してから、このメソッドを再試行してください。

アプリのユーザーごとに作成できるデバイスは 100 台までです。この上限を超えると、RESOURCE_EXHAUSTED エラーが返されます。

HTTP リクエスト

POST https://photosambient.googleapis.com/v1/devices

この URL は gRPC Transcoding 構文を使用します。

クエリ パラメータ

パラメータ
requestId

string

省略可。このリクエストの一意の識別子（クライアント提供）。これは、ネットワーク障害が発生した場合のリソースの重複を軽減するために使用されます。

この ID は UUID（バージョン 4）文字列の形式で、次の要件を満たしている必要があります。

  • ユーザーの機密性の高い個人情報は含めないでください。
  • 32 桁の 16 進数を 5 つのグループに分割し、ハイフンで区切った「xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx」（または 8-4-4-4-12）の形式で指定する必要があります。

リクエストの本文

リクエストの本文には AmbientDevice のインスタンスが含まれます。

レスポンスの本文

成功した場合、レスポンスの本文には、新しく作成された AmbientDevice のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/photosambient.mediaitems