Method: people.connections.list

প্রমাণীকৃত ব্যবহারকারীর পরিচিতিগুলির একটি তালিকা প্রদান করে।

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

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

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

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

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

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

HTTP অনুরোধ

GET https://people.googleapis.com/v1/{resourceName=people/*}/connections

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

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

পরামিতি
resourceName
(deprecated)

string

প্রয়োজন। রিসোর্সের নাম যার জন্য সংযোগ ফেরত দিতে হবে। শুধুমাত্র people/me বৈধ.

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

পরামিতি
pageToken

string

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

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

pageSize

integer

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

sortOrder

enum ( SortOrder )

ঐচ্ছিক। যে ক্রমে সংযোগগুলি সাজানো উচিত৷ LAST_MODIFIED_ASCENDING এ ডিফল্ট।

requestSyncToken

boolean

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

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

syncToken

string

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

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

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

requestMask
(deprecated)

object ( RequestMask )

ঐচ্ছিক। বঞ্চিত (অনুগ্রহ করে এর পরিবর্তে personFields ব্যবহার করুন)

ব্যক্তি ক্ষেত্রের একটি উপসেটে ফলাফল সীমাবদ্ধ করার জন্য একটি মুখোশ।

personFields

string ( FieldMask format)

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

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

enum ( ReadSourceType )

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

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

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

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

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

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

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

object ( Person )

অনুরোধকারী সংযুক্ত ব্যক্তিদের তালিকা।

nextPageToken

string

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

nextSyncToken

string

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

totalPeople
(deprecated)

integer

অপ্রচলিত (অনুগ্রহ করে টোটাল আইটেম ব্যবহার করুন) পেজিনেশন ছাড়া তালিকায় মোট লোকের সংখ্যা।

totalItems

integer

পেজিনেশন ছাড়া তালিকায় মোট আইটেম সংখ্যা.

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

নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:

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

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

সাজানোর অর্ডার

যে ক্রমে সংযোগের তালিকা বাছাই করা উচিত। সিঙ্কের অনুরোধ না করলেই এটি ব্যবহার করা হয়।

Enums
LAST_MODIFIED_ASCENDING যখন তারা পরিবর্তিত হয়েছিল তখন অনুসারে লোকেদের সাজান; পুরানো এন্ট্রি প্রথম.
LAST_MODIFIED_DESCENDING যখন তারা পরিবর্তিত হয়েছিল তখন অনুসারে লোকেদের সাজান; নতুন এন্ট্রি প্রথম.
FIRST_NAME_ASCENDING নাম অনুসারে লোকেদের সাজান।
LAST_NAME_ASCENDING পদবি অনুসারে লোকেদের সাজান।