Method: photos.batchUpdate

Photos का मेटाडेटा अपडेट करता है, जैसे पोज़, जगह की जानकारी, कनेक्शन वगैरह. फ़ोटो के पिक्सल बदलने की सुविधा काम नहीं करती.

ध्यान दें कि अगर photos.batchUpdate कोड जनरेट नहीं होता है, तो या तो ज़रूरी फ़ील्ड मौजूद नहीं हैं या पुष्टि करने में कोई गड़बड़ी हुई है. photos.batchUpdate के सफल होने पर भी, हो सकता है कि बैच में मौजूद अलग-अलग फ़ोटो काम न करें. इन गड़बड़ियों की जानकारी, BatchUpdatePhotosResponse.results के हर PhotoResponse.status में दी गई है. हर फ़ोटो के साथ होने वाली खास गड़बड़ियों के बारे में जानने के लिए, photo.update पर जाएं.

सिर्फ़ updateMask फ़ील्ड में दिए गए फ़ील्ड का इस्तेमाल किया जाता है. अगर updateMask मौजूद नहीं है, तो यह अपडेट सभी फ़ील्ड पर लागू होता है.

BatchUpdatePhotosRequest में UpdatePhotoRequest मैसेज की संख्या 20 से ज़्यादा नहीं होनी चाहिए.

ध्यान दें: Pose.altitude को अपडेट करने के लिए, Pose.latLngPair को भी भरना होगा. ऐसा न करने पर, अनुरोध स्वीकार नहीं किया जाएगा.

एचटीटीपी अनुरोध

POST https://streetviewpublish.googleapis.com/v1/photos:batchUpdate

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "updatePhotoRequests": [
    {
      "photo": {
        object (Photo)
      },
      "updateMask": string
    }
  ]
}
फ़ील्ड
updatePhotoRequests[]

object

ज़रूरी है. UpdatePhotoRequests की सूची.
updatePhotoRequests[].photo

object (Photo)

ज़रूरी है. Photo ऑब्जेक्ट में नया मेटाडेटा है.
updatePhotoRequests[].updateMask

string (FieldMask format)

ज़रूरी है. मास्क जो अपडेट किए जाने वाले फ़ोटो मेटाडेटा पर फ़ील्ड की पहचान करता है. अगर यह मेटाडेटा मौजूद नहीं होता है, तो इस अनुरोध में पुराने Photo मेटाडेटा को नए Photo मेटाडेटा से बदल दिया जाता है. अमान्य फ़ील्ड दिए जाने पर अपडेट नहीं होता. एक से ज़्यादा फ़ील्ड को कॉमा-डीलिमिटेड सूची के तौर पर सेट किया जा सकता है.

ये फ़ील्ड मान्य हैं:

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

ध्यान दें: जब updateMask में दोहराए गए फ़ील्ड होते हैं, तो दोहराए गए मानों का पूरा सेट नई सामग्री से बदल जाता है. उदाहरण के लिए, अगर updateMask में connections है और UpdatePhotoRequest.photo.connections खाली है, तो सभी कनेक्शन हटा दिए जाते हैं.

जवाब का मुख्य भाग

एक या ज़्यादा Photos के मेटाडेटा के बैच अपडेट का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

JSON के काेड में दिखाना 
{
  "results": [
    {
      object (PhotoResponse)
    }
  ]
}
फ़ील्ड
results[]

object (PhotoResponse)

हर Photo के लिए, नतीजों की सूची, अनुरोध के क्रम में अपडेट की गई.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.