Method: people.updateContact

একটি বিদ্যমান যোগাযোগ ব্যক্তির জন্য যোগাযোগের ডেটা আপডেট করুন। কোনো অ-যোগাযোগ তথ্য পরিবর্তন করা হবে না. আপডেট করার জন্য ব্যক্তির মধ্যে কোনো অ-যোগাযোগ ডেটা উপেক্ষা করা হবে। updateMask নির্দিষ্ট করা সমস্ত ক্ষেত্র প্রতিস্থাপন করা হবে।

সার্ভার একটি 400 ত্রুটি প্রদান করে যদি person.metadata.sources পরিচিতি আপডেট করার জন্য নির্দিষ্ট করা না থাকে বা কোনো যোগাযোগের উৎস না থাকে।

যদি person.metadata.sources.etag পরিচিতির etag থেকে আলাদা হয়, তাহলে সার্ভারটি "failedPrecondition" কারণ সহ একটি 400 ত্রুটি ফেরত দেয়, যা নির্দেশ করে যে পরিচিতিটি ডেটা পড়ার পর থেকে পরিবর্তিত হয়েছে৷ ক্লায়েন্টদের সর্বশেষ ব্যক্তিকে পেতে হবে এবং তাদের আপডেটগুলি সর্বশেষ ব্যক্তির সাথে একত্রিত করতে হবে।

memberships আপডেট করা হলে সার্ভার একটি 400 ত্রুটি প্রদান করে এবং ব্যক্তির উপর নির্দিষ্ট কোনো যোগাযোগ গোষ্ঠী সদস্যতা না থাকে।

সার্ভারটি একটি 400 ত্রুটি প্রদান করে যদি একটি ক্ষেত্রে একাধিক ক্ষেত্র নির্দিষ্ট করা হয় যা যোগাযোগের উত্সগুলির জন্য একটি সিঙ্গলটন:

  • জীবনী
  • জন্মদিন
  • লিঙ্গ
  • নাম

ক্রমবর্ধমান বিলম্ব এবং ব্যর্থতা এড়াতে একই ব্যবহারকারীর জন্য মিউটেটের অনুরোধগুলি ক্রমানুসারে পাঠানো উচিত।

HTTP অনুরোধ

PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

পাথ প্যারামিটার

পরামিতি
person.resourceName

string

ব্যক্তির জন্য সম্পদের নাম, সার্ভার দ্বারা নির্ধারিত। people/{person_id} আকারে একটি ASCII স্ট্রিং।

ক্যোয়ারী প্যারামিটার

পরামিতি
updatePersonFields

string ( FieldMask format)

প্রয়োজন। ব্যক্তির কোন ক্ষেত্র আপডেট করা হয় তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক। একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। সমস্ত আপডেট ক্ষেত্র প্রতিস্থাপন করা হবে. বৈধ মান হল:

  • ঠিকানা
  • জীবনী
  • জন্মদিন
  • ক্যালেন্ডার ইউআরএল
  • ক্লায়েন্ট ডেটা
  • ইমেইল ঠিকানা
  • ঘটনা
  • বাহ্যিক আইডি
  • লিঙ্গ
  • ক্লায়েন্ট
  • স্বার্থ
  • লোকেল
  • অবস্থান
  • সদস্যপদ
  • মিসকিওয়ার্ড
  • নাম
  • ডাকনাম
  • পেশা
  • সংগঠন
  • ফোন নাম্বারগুলো
  • সম্পর্ক
  • sip ঠিকানা
  • ইউআরএল
  • ব্যবহারকারী সংজ্ঞায়িত
personFields

string ( FieldMask format)

ঐচ্ছিক। প্রতিটি ব্যক্তির কোন ক্ষেত্রগুলি ফেরত দেওয়া হবে তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক৷ একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। সেট না থাকলে সব ক্ষেত্রেই ডিফল্ট। বৈধ মান হল:

  • ঠিকানা
  • বয়সসীমা
  • জীবনী
  • জন্মদিন
  • ক্যালেন্ডার ইউআরএল
  • ক্লায়েন্ট ডেটা
  • আচ্ছাদিত ছবি
  • ইমেইল ঠিকানা
  • ঘটনা
  • বাহ্যিক আইডি
  • লিঙ্গ
  • ক্লায়েন্ট
  • স্বার্থ
  • লোকেল
  • অবস্থান
  • সদস্যপদ
  • মেটাডেটা
  • মিসকিওয়ার্ড
  • নাম
  • ডাকনাম
  • পেশা
  • সংগঠন
  • ফোন নাম্বারগুলো
  • ফটো
  • সম্পর্ক
  • sip ঠিকানা
  • দক্ষতা
  • ইউআরএল
  • ব্যবহারকারী সংজ্ঞায়িত
sources[]

enum ( ReadSourceType )

ঐচ্ছিক। কোন উৎসের ধরন ফেরাতে হবে তার একটি মুখোশ। READ_SOURCE_TYPE_CONTACT এবং READ_SOURCE_TYPE_PROFILE সেট না থাকলে ডিফল্ট।

শরীরের অনুরোধ

অনুরোধের অংশে Person একটি উদাহরণ রয়েছে।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে Person একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

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

আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।