Method: otherContacts.list

সমস্ত "অন্যান্য পরিচিতি" তালিকাভুক্ত করুন, এটি এমন পরিচিতি যা একটি পরিচিতি গোষ্ঠীতে নেই৷ "অন্যান্য পরিচিতি" সাধারণত ইন্টারঅ্যাকশন থেকে স্বয়ংক্রিয়ভাবে তৈরি পরিচিতি।

সিঙ্ক টোকেন সম্পূর্ণ সিঙ্কের 7 দিন পরে মেয়াদ শেষ হয়। মেয়াদোত্তীর্ণ সিঙ্ক টোকেন সহ একটি অনুরোধ google.rpc.ErrorInfo এর সাথে একটি ত্রুটি পাবে কারণ "EXPIRED_SYNC_TOKEN"৷ এই ধরনের ত্রুটির ক্ষেত্রে ক্লায়েন্টদের একটি syncToken ছাড়াই একটি সম্পূর্ণ সিঙ্ক অনুরোধ করা উচিত।

একটি সম্পূর্ণ সিঙ্ক অনুরোধের প্রথম পৃষ্ঠায় একটি অতিরিক্ত কোটা রয়েছে৷ কোটা অতিক্রম করা হলে, একটি 429 ত্রুটি ফেরত দেওয়া হবে। এই কোটা নির্দিষ্ট এবং বাড়ানো যাবে না।

যখন syncToken নির্দিষ্ট করা হয়, শেষ সিঙ্কের পর থেকে মুছে ফেলা সংস্থানগুলিকে PersonMetadata.deleted সত্য হিসাবে সেট করা ব্যক্তি হিসাবে ফেরত দেওয়া হবে।

যখন pageToken বা syncToken নির্দিষ্ট করা হয়, তখন অন্য সমস্ত অনুরোধের প্যারামিটার অবশ্যই প্রথম কলের সাথে মেলে।

সিঙ্ক অনুরোধের জন্য রাইটগুলির প্রচারে কয়েক মিনিট বিলম্ব হতে পারে। ক্রমবর্ধমান সিঙ্ক পঠন-পরে-লেখা ব্যবহারের ক্ষেত্রে উদ্দেশ্যে নয়।

পরিবর্তিত ব্যবহারকারীর অন্যান্য পরিচিতির তালিকায় উদাহরণ ব্যবহার দেখুন।

HTTP অনুরোধ

GET https://people.googleapis.com/v1/otherContacts

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

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

পরামিতি
pageToken

string

ঐচ্ছিক। একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী প্রতিক্রিয়া nextPageToken থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এটি প্রদান করুন।

পেজিনেট করার সময়, otherContacts.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই পৃষ্ঠা টোকেন প্রদানকারী প্রথম কলের সাথে মেলে।

pageSize

integer

ঐচ্ছিক। প্রতিক্রিয়াতে অন্তর্ভুক্ত করার জন্য "অন্যান্য পরিচিতি" এর সংখ্যা৷ বৈধ মানগুলি 1 থেকে 1000 এর মধ্যে, অন্তর্ভুক্ত। ডিফল্ট 100 সেট না থাকলে বা 0 এ সেট করা হয়।

requestSyncToken

boolean

ঐচ্ছিক। ফলাফলের শেষ পৃষ্ঠায় প্রতিক্রিয়া nextSyncToken ফিরে আসবে কিনা। এটি অনুরোধ syncToken এ সেট করে শেষ অনুরোধ থেকে ক্রমবর্ধমান পরিবর্তন পেতে ব্যবহার করা যেতে পারে।

otherContacts.list এ সিঙ্ক আচরণ সম্পর্কে আরও বিশদ বিবরণ।

syncToken

string

ঐচ্ছিক। একটি সিঙ্ক টোকেন, একটি পূর্ববর্তী প্রতিক্রিয়া থেকে প্রাপ্ত nextSyncToken শুধুমাত্র শেষ অনুরোধের পর থেকে পরিবর্তিত সম্পদ পুনরুদ্ধার করতে এটি প্রদান করুন।

সিঙ্ক করার সময়, otherContacts.list এ প্রদত্ত অন্যান্য সমস্ত প্যারামিটার অবশ্যই সিঙ্ক টোকেন প্রদানকারী প্রথম কলের সাথে মেলে।

otherContacts.list এ সিঙ্ক আচরণ সম্পর্কে আরও বিশদ বিবরণ।

readMask

string ( FieldMask format)

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

যদি READ_SOURCE_TYPE_CONTACT ব্যবহার করা হয়, তাহলে বৈধ মানগুলি হল:

  • ইমেইল ঠিকানা
  • মেটাডেটা
  • নাম
  • ফোন নাম্বারগুলো
  • ফটো

যদি READ_SOURCE_TYPE_PROFILE ব্যবহার করা হয়, তাহলে বৈধ মানগুলি হল:

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

enum ( ReadSourceType )

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

এই ক্ষেত্রের জন্য সম্ভাব্য মান হল:

READ_SOURCE_TYPE_CONTACT উল্লেখ না করে READ_SOURCE_TYPE_PROFILE নির্দিষ্ট করা অনুমোদিত নয়৷

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

অনুরোধের বডি খালি হতে হবে।

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

প্রমাণীকৃত ব্যবহারকারীর "অন্যান্য পরিচিতি" এর জন্য একটি অনুরোধের প্রতিক্রিয়া।

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

JSON প্রতিনিধিত্ব
{
  "otherContacts": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "totalSize": integer
}
ক্ষেত্র
otherContacts[]

object ( Person )

"অন্যান্য পরিচিতিগুলির" তালিকা ব্যক্তি সম্পদ হিসাবে ফিরে এসেছে৷ "অন্যান্য পরিচিতি" ক্ষেত্রের একটি সীমিত উপসেট সমর্থন করে। আরো বিস্তারিত তথ্যের জন্য ListOtherContactsRequest.request_mask দেখুন।

nextPageToken

string

একটি টোকেন, যা পরবর্তী পৃষ্ঠা পুনরুদ্ধার করতে pageToken হিসাবে পাঠানো যেতে পারে। যদি এই ক্ষেত্রটি বাদ দেওয়া হয়, তাহলে পরবর্তী পৃষ্ঠা থাকবে না।

nextSyncToken

string

একটি টোকেন, যা শেষ অনুরোধ থেকে পরিবর্তনগুলি পুনরুদ্ধার করতে syncToken হিসাবে পাঠানো যেতে পারে। সিঙ্ক টোকেন ফেরত দিতে রিকোয়েস্টকে requestSyncToken সেট করতে হবে।

totalSize

integer

পৃষ্ঠা সংখ্যা ছাড়া তালিকায় অন্যান্য পরিচিতির মোট সংখ্যা।

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

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

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

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