Method: photo.update

Photo のメタデータ(ポーズ、場所の関連付け、接続など)を更新します。写真のピクセルを変更することはできません。

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

このメソッドは、次のエラーコードを返します。

HTTP リクエスト

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

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

パスパラメータ

パラメータ
photo.photoId.id

string

写真の一意の識別子。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

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

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

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

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

リクエストの本文

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

レスポンスの本文

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

認可スコープ

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

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

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