Method: photos.batchUpdate

ポーズ、場所の関連付け、結合など、Photos のメタデータを更新します。写真のピクセルの変更はサポートされていません。

photos.batchUpdate が失敗する場合は、重要なフィールドがないか、認証エラーがあることに注意してください。photos.batchUpdate が成功しても、バッチ内の個々の写真でエラーが発生する場合があります。これらの失敗は、BatchUpdatePhotosResponse.results の各 PhotoResponse.status で指定されます。写真ごとに発生する可能性のある具体的なエラーについては、photo.update をご覧ください。

updateMask フィールドで指定されたフィールドのみが使用されます。updateMask が存在しない場合、すべてのフィールドに更新が適用されます。

BatchUpdatePhotosRequest 内の UpdatePhotoRequest メッセージの数は 20 以下にしてください。

注: Pose.altitude を更新するには、Pose.latLngPair も入力する必要があります。一致していないと、リクエストは失敗します。

HTTP リクエスト

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

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

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
フィールド
updatePhotoRequests[]

object

必須。UpdatePhotoRequests のリスト。
updatePhotoRequests[].photo

object (Photo)

必須。新しいメタデータを含む Photo オブジェクト。
updatePhotoRequests[].updateMask

string (FieldMask format)

必須。更新する写真メタデータのフィールドを識別するマスク。存在しない場合、このリクエストでは古い Photo メタデータが新しい Photo メタデータに完全に置き換えられます。無効なフィールドを指定すると更新が失敗します。カンマ区切りリストで複数のフィールドを指定できます。

有効なフィールドは次のとおりです。

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

注: updateMask に繰り返しフィールドが含まれている場合、繰り返し値のセット全体が新しい内容に置き換えられます。たとえば、updateMask に connections が含まれ、UpdatePhotoRequest.photo.connections が空の場合、すべての接続が削除されます。

レスポンスの本文

1 つ以上の Photos のメタデータのバッチ更新に対するレスポンス。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
フィールド
results[]

object (PhotoResponse)

更新された個々の Photo の結果のリスト（リクエストと同じ順序で）。

認可スコープ

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

  • https://www.googleapis.com/auth/streetviewpublish

詳細については、OAuth 2.0 の概要をご覧ください。