Method: contactGroups.update

প্রমাণীকৃত ব্যবহারকারীর মালিকানাধীন একটি বিদ্যমান পরিচিতি গোষ্ঠীর নাম আপডেট করুন৷

আপডেট করা পরিচিতি গোষ্ঠীর নাম অবশ্যই ব্যবহারকারীদের পরিচিতি গোষ্ঠীর জন্য অনন্য হতে হবে। একটি ডুপ্লিকেট নাম দিয়ে একটি গ্রুপ তৈরি করার চেষ্টা করলে একটি HTTP 409 ত্রুটি ফিরে আসবে৷

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

HTTP অনুরোধ

PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}

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

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

পরামিতি
contactGroup.resourceName

string

পরিচিতি গোষ্ঠীর জন্য সম্পদের নাম, সার্ভার দ্বারা নির্ধারিত। একটি ASCII স্ট্রিং, contactGroups/{contactGroupId} আকারে।

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

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

JSON প্রতিনিধিত্ব 
{
  "contactGroup": {
    "resourceName": string,
    "etag": string,
    "metadata": {
      "updateTime": string,
      "deleted": boolean
    },
    "groupType": enum (GroupType),
    "name": string,
    "formattedName": string,
    "memberResourceNames": [
      string
    ],
    "memberCount": integer,
    "clientData": [
      {
        "key": string,
        "value": string
      }
    ]
  },
  "updateGroupFields": string,
  "readGroupFields": string
}
ক্ষেত্র
contactGroup.etag

string

সম্পদের HTTP সত্তা ট্যাগ । ওয়েব ক্যাশে যাচাইকরণের জন্য ব্যবহৃত হয়।

contactGroup.metadata

object ( ContactGroupMetadata )

শুধুমাত্র আউটপুট। পরিচিতি গ্রুপ সম্পর্কে মেটাডেটা।

contactGroup.groupType

enum ( GroupType )

শুধুমাত্র আউটপুট। যোগাযোগের গ্রুপের ধরন।

contactGroup.name

string

গ্রুপ মালিক কর্তৃক সেট করা পরিচিতি গ্রুপের নাম অথবা সিস্টেম গ্রুপের জন্য একটি সিস্টেম প্রদত্ত নাম।

contactGroups.create বা contactGroups.update জন্য ব্যবহারকারীদের যোগাযোগ গোষ্ঠীর জন্য নামটি অনন্য হতে হবে। একটি ডুপ্লিকেট নাম দিয়ে একটি গ্রুপ তৈরি করার চেষ্টা করলে একটি HTTP 409 ত্রুটি ফিরে আসবে৷

contactGroup.formattedName

string

শুধুমাত্র আউটপুট। ভিউয়ারের অ্যাকাউন্ট লোকেলে বা সিস্টেম গ্রুপের নামের জন্য Accept-Language HTTP হেডার লোকেলে অনুবাদ ও ফর্ম্যাট করা নাম। মালিকের দ্বারা সেট করা গ্রুপ নামগুলি নামের মতোই।

contactGroup.memberResourceNames[]

string

শুধুমাত্র আউটপুট। যোগাযোগ ব্যক্তির সম্পদ নামের তালিকা যারা যোগাযোগ গোষ্ঠীর সদস্য। ক্ষেত্রটি শুধুমাত্র GET অনুরোধের জন্য জনবহুল এবং শুধুমাত্র অনুরোধে maxMembers সদস্য যতগুলি সদস্য থাকবে তত বেশি সদস্যকে ফিরিয়ে দেবে।

contactGroup.memberCount

integer

শুধুমাত্র আউটপুট। অনুরোধে উল্লেখ করা সর্বোচ্চ সদস্য নির্বিশেষে গ্রুপে পরিচিতির মোট সংখ্যা।

contactGroup.clientData[]

object ( GroupClientData )

গ্রুপের ক্লায়েন্ট ডেটা।

updateGroupFields

string ( FieldMask format)

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

  • ক্লায়েন্ট ডেটা
  • নাম
readGroupFields

string ( FieldMask format)

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

  • ক্লায়েন্ট ডেটা
  • গ্রুপ টাইপ
  • সদস্য সংখ্যা
  • মেটাডেটা
  • নাম

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

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

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

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

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

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