Method: people.batchUpdateContacts

পরিচিতিগুলির একটি ব্যাচ আপডেট করুন এবং আপডেট করা পরিচিতিগুলির জন্য ব্যক্তিপ্রতিক্রিয়াগুলিতে সম্পদের নামের একটি মানচিত্র ফেরত দিন৷

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

HTTP অনুরোধ

POST https://people.googleapis.com/v1/people:batchUpdateContacts

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

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

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব
{
  "contacts": {
    string: {
      object (Person)
    },
    ...
  },
  "updateMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
ক্ষেত্র
contacts

map (key: string, value: object ( Person ))

প্রয়োজন। আপডেট করা ব্যক্তির তথ্য সম্পদ নামের একটি মানচিত্র. একক অনুরোধে 200টি পরিচিতির অনুমতি দেয়৷

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

updateMask

string ( FieldMask format)

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

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

string ( FieldMask format)

প্রয়োজন। প্রতিটি ব্যক্তির কোন ক্ষেত্রগুলি ফেরত দেওয়া হবে তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক৷ একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। যদি রিড মাস্ক খালি রাখা হয়, পোস্ট-মিউটেট-গেট এড়িয়ে যায় এবং প্রতিক্রিয়াতে কোনও ডেটা ফেরত দেওয়া হবে না। বৈধ মান হল:

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

enum ( ReadSourceType )

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

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

সফল না হলে, BatchUpdateContactsErrorDetails প্রদান করে, প্রতিটি পরিচিতির সাথে সম্পর্কিত ত্রুটির একটি তালিকা।

পরিচিতিগুলির একটি ব্যাচ আপডেট করার অনুরোধের প্রতিক্রিয়া৷

সফল হলে, প্রতিক্রিয়া বডিতে নিম্নলিখিত কাঠামোর সাথে ডেটা থাকে:

JSON প্রতিনিধিত্ব
{
  "updateResult": {
    string: {
      object (PersonResponse)
    },
    ...
  }
}
ক্ষেত্র
updateResult

map (key: string, value: object ( PersonResponse ))

রিকোয়েস্ট readMask খালি না থাকলে আপডেট করা পরিচিতিগুলোর রিসোর্স নামের ম্যাপ।

"key": value জোড়া। উদাহরণ: { "name": "wrench", "mass": "1.3kg", "count": "3" }

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

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

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

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