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 の概要をご覧ください。