يعدِّل البيانات الوصفية لـ 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 ( |
الحقول | |
---|---|
updatePhotoRequests[] |
مطلوبة. قائمة |
updatePhotoRequests[].photo |
مطلوبة. |
updatePhotoRequests[].updateMask |
مطلوبة. قناع يحدد الحقول في البيانات الوصفية للصورة المطلوب تعديلها. وفي حال عدم توفّر هذه البيانات، يتم استبدال بيانات الحقول التالية صالحة:
|
نص الاستجابة
ردّ على تعديل مجمّع للبيانات الوصفية من نوع Photos
واحد أو أكثر
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"results": [
{
object ( |
الحقول | |
---|---|
results[] |
تم تعديل قائمة النتائج لكل |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/streetviewpublish
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.