- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
किसी संपर्क की फ़ोटो अपडेट करें.
एक ही उपयोगकर्ता के लिए म्यूटेट अनुरोधों को क्रम से भेजा जाना चाहिए, ताकि इंतज़ार के समय में बढ़ोतरी और विफलताओं से बचा जा सके.
एचटीटीपी अनुरोध
PATCH https://people.googleapis.com/v1/{resourceName=people/*}:updateContactPhoto
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
resourceName |
ज़रूरी है. व्यक्ति के संसाधन का नाम |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"photoBytes": string,
"personFields": string,
"sources": [
enum ( |
फ़ील्ड | |
---|---|
photoBytes |
ज़रूरी है. रॉ फ़ोटो बाइट base64 कोड में बदली गई स्ट्रिंग. |
personFields |
ज़रूरी नहीं. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि व्यक्ति के कौनसे फ़ील्ड वापस दिखाए जाएं. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. अगर नीति को सेट नहीं किया जाता है, तो डिफ़ॉल्ट तौर पर यह खाली होता है. इससे पोस्ट में बदलाव नहीं किया जा सकता. मान्य मान हैं:
|
sources[] |
ज़रूरी नहीं. इस बात का मास्क कि किस तरह के सोर्स को दिखाया जाए. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट वैल्यू |
जवाब का मुख्य भाग
किसी संपर्क की फ़ोटो अपडेट करने पर दिया गया जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"person": {
object ( |
फ़ील्ड | |
---|---|
person |
अपडेट किया गया व्यक्ति, अगर personFields, UpdateContact PhotoRequest में सेट है, तो उसे सेट नहीं किया जाएगा. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.