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