Method: photos.batchUpdate
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتم تعديل البيانات الوصفية لـ Photos، مثل الوضعية وربطها بالمكان والاتصالات وما إلى ذلك. لا يمكن تغيير وحدات بكسل الصور.
يُرجى العِلم أنّه في حال تعذّر تنفيذ photos.batchUpdate، هذا يعني أن الحقول المهمة غير متوفرة أو هناك خطأ في المصادقة. حتى في حال نجاح "photos.batchUpdate"، قد تتعذّر الصور الفردية في المجموعة. ويتم تحديد أعطال التطبيق هذه في كل PhotoResponse.status في BatchUpdatePhotosResponse.results. راجِع photo.update للتعرّف على أخطاء معيّنة يمكن أن تحدث لكل صورة.
يتم استخدام الحقول المحددة في الحقل updateMask فقط. في حال عدم توفّر السمة updateMask، سيسري التعديل على جميع الحقول.
يجب ألا يتجاوز عدد رسائل UpdatePhotoRequest في BatchUpdatePhotosRequest 20 رسالة.
ملاحظة: لتعديل Pose.altitude، يجب ملء الحقل Pose.latLngPair أيضًا. وإلا، سيفشل الطلب.
طلب HTTP
POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
| تمثيل JSON |
{
"updatePhotoRequests": [
{
"photo": {
object (Photo)
},
"updateMask": string
}
]
} |
| الحقول |
updatePhotoRequests[] |
object
مطلوب. قائمة UpdatePhotoRequests
|
updatePhotoRequests[].photo |
object (Photo)
مطلوب. عنصر Photo يحتوي على البيانات الوصفية الجديدة.
|
updatePhotoRequests[].updateMask |
string (FieldMask format)
مطلوب. قناع يحدّد الحقول في البيانات الوصفية للصورة المطلوب تعديلها في حال عدم توفّر بيانات Photo الوصفية القديمة، سيتم استبدال بيانات Photo الوصفية الجديدة بالكامل في هذا الطلب. يتعذّر التعديل في حال تحديد حقول غير صالحة. يمكن تحديد حقول متعددة في قائمة مفصولة بفواصل. الحقول التالية صالحة:
pose.headingpose.lat_lng_pairpose.pitchpose.rollpose.levelpose.altitudeconnectionsplaces
ملاحظة: عندما يحتوي updateMask على حقول متكرّرة، يتم استبدال مجموعة القيم المتكرّرة بالكامل بالمحتوى الجديد. على سبيل المثال، إذا كان الحقل "updateMask" يحتوي على الحقل "connections" وكان الحقل "UpdatePhotoRequest.photo.connections" فارغًا، ستتم إزالة جميع عمليات الربط.
|
نص الاستجابة
ردّ على تعديل مجمّع للبيانات الوصفية لواحدة أو أكثر من Photos.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| الحقول |
results[] |
object (PhotoResponse)
يتم تعديل قائمة النتائج لكل Photo فردي، بترتيب الطلب نفسه.
|
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/streetviewpublish
لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-09-10 (حسب التوقيت العالمي المتفَّق عليه)"],[[["The API updates metadata of photos, such as pose, connections, and place association, but does not change pixel data."],["Requests are submitted as a batch of up to 20 `UpdatePhotoRequest` messages specifying the photo and fields to update."],["If the `updateMask` is not provided, all fields of the Photo resource will be updated with the values provided in the request."],["When updating `Pose.altitude`, `Pose.latLngPair` must also be specified, or the request will fail."],["This API requires the `https://www.googleapis.com/auth/streetviewpublish` OAuth scope for authorization."]]],[]]
