Method: photo.update

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

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

इस तरीके से ये गड़बड़ी कोड मिलते हैं:

  • google.rpc.Code.PERMISSION_DENIED, अगर अनुरोध करने वाले उपयोगकर्ता ने अनुरोध की गई फ़ोटो नहीं बनाई.
  • google.rpc.Code.INVALID_ARGUMENT, अगर अनुरोध गलत तरीके से किया गया है.
  • अगर अनुरोध की गई फ़ोटो मौजूद नहीं है, तो google.rpc.Code.NOT_FOUND.
  • google.rpc.Code.UNAVAILABLE, अगर अनुरोध किया गया Photo अब भी इंडेक्स किया जा रहा है.

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

PUT https://streetviewpublish.googleapis.com/v1/photo/{photo.photoId.id}

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

पाथ के पैरामीटर

पैरामीटर
photo.photoId.id

string

फ़ोटो के लिए यूनीक आइडेंटिफ़ायर.

क्वेरी पैरामीटर

पैरामीटर
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 खाली है, तो सभी कनेक्शन हटा दिए जाएंगे.

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

अनुरोध के मुख्य भाग में Photo का उदाहरण है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Photo का एक इंस्टेंस शामिल किया जाता है.

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

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

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

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