更新 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
這個網址使用 gRPC 轉碼語法。
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"updatePhotoRequests": [
{
"photo": {
object ( |
欄位 | |
---|---|
updatePhotoRequests[] |
必要欄位。 |
updatePhotoRequests[].photo |
必要欄位。包含新中繼資料的 |
updatePhotoRequests[].updateMask |
必要欄位。這個遮罩可識別要更新的相片中繼資料欄位。如果沒有,則這項要求中的舊 以下是有效的欄位:
|
回應主體
回應一或多個 Photos
的中繼資料批次更新。
如果成功,回應主體會含有以下結構的資料:
JSON 表示法 |
---|
{
"results": [
{
object ( |
欄位 | |
---|---|
results[] |
每個 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/streetviewpublish
詳情請參閱 OAuth 2.0 總覽。