- HTTP অনুরোধ
- পাথ প্যারামিটার
- ক্যোয়ারী প্যারামিটার
- শরীরের অনুরোধ
- প্রতিক্রিয়া শরীর
- অনুমোদনের সুযোগ
- এটা চেষ্টা করুন!
একটি বিদ্যমান যোগাযোগ ব্যক্তির জন্য যোগাযোগের ডেটা আপডেট করুন। কোনো অ-যোগাযোগ তথ্য পরিবর্তন করা হবে না. আপডেট করার জন্য ব্যক্তির মধ্যে কোনো অ-যোগাযোগ ডেটা উপেক্ষা করা হবে। updateMask নির্দিষ্ট করা সমস্ত ক্ষেত্র প্রতিস্থাপন করা হবে।
সার্ভার একটি 400 ত্রুটি প্রদান করে যদি person.metadata.sources পরিচিতি আপডেট করার জন্য নির্দিষ্ট করা না থাকে বা কোনো যোগাযোগের উৎস না থাকে।
যদি person.metadata.sources.etag পরিচিতির etag থেকে আলাদা হয়, তাহলে সার্ভারটি "failedPrecondition" কারণ সহ একটি 400 ত্রুটি ফেরত দেয়, যা নির্দেশ করে যে পরিচিতিটি ডেটা পড়ার পর থেকে পরিবর্তিত হয়েছে৷ ক্লায়েন্টদের সর্বশেষ ব্যক্তিকে পেতে হবে এবং তাদের আপডেটগুলি সর্বশেষ ব্যক্তির সাথে একত্রিত করতে হবে। একই ব্যক্তিকে ক্রমিক আপডেট করা হলে, ব্যর্থতা এড়াতে updateContact প্রতিক্রিয়া থেকে etag ব্যবহার করা উচিত।
memberships আপডেট করা হলে সার্ভার একটি 400 ত্রুটি প্রদান করে এবং ব্যক্তির উপর নির্দিষ্ট কোনো যোগাযোগ গোষ্ঠী সদস্যতা না থাকে।
সার্ভারটি একটি 400 ত্রুটি প্রদান করে যদি একটি ক্ষেত্রে একাধিক ক্ষেত্র নির্দিষ্ট করা হয় যা যোগাযোগের উত্সগুলির জন্য একটি সিঙ্গলটন:
- জীবনী
- জন্মদিন
- লিঙ্গ
- নাম
ক্রমবর্ধমান বিলম্ব এবং ব্যর্থতা এড়াতে একই ব্যবহারকারীর জন্য মিউটেটের অনুরোধগুলি ক্রমানুসারে পাঠানো উচিত।
HTTP অনুরোধ
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
পাথ প্যারামিটার
| পরামিতি | |
|---|---|
person.resourceName | ব্যক্তির জন্য সম্পদের নাম, সার্ভার দ্বারা নির্ধারিত। |
ক্যোয়ারী প্যারামিটার
| পরামিতি | |
|---|---|
updatePersonFields | প্রয়োজন। ব্যক্তির কোন ক্ষেত্র আপডেট করা হয় তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক। একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। সমস্ত আপডেট ক্ষেত্র প্রতিস্থাপন করা হবে. বৈধ মান হল:
|
personFields | ঐচ্ছিক। প্রতিটি ব্যক্তির কোন ক্ষেত্রগুলি ফেরত দেওয়া হবে তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক৷ একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। সেট না থাকলে সব ক্ষেত্রেই ডিফল্ট। বৈধ মান হল:
|
sources[] | ঐচ্ছিক। কোন উৎসের ধরন ফেরাতে হবে তার একটি মুখোশ। |
শরীরের অনুরোধ
অনুরোধের অংশে Person একটি উদাহরণ রয়েছে।
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে Person একটি উদাহরণ থাকে।
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগ প্রয়োজন:
-
https://www.googleapis.com/auth/contacts
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।