ポーズ、場所の関連付け、結合など、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 ( |
フィールド | |
---|---|
updatePhotoRequests[] |
必須。 |
updatePhotoRequests[].photo |
必須。新しいメタデータを含む |
updatePhotoRequests[].updateMask |
必須。更新する写真メタデータのフィールドを識別するマスク。存在しない場合、このリクエストでは古い 有効なフィールドは次のとおりです。
|
レスポンスの本文
1 つ以上の Photos
のメタデータのバッチ更新に対するレスポンス。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"results": [
{
object ( |
フィールド | |
---|---|
results[] |
更新された個々の |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/streetviewpublish
詳細については、OAuth 2.0 の概要をご覧ください。