প্রমাণীকৃত ব্যবহারকারীর গোষ্ঠীবদ্ধ পরিচিতিগুলিতে পরিচিতির একটি তালিকা প্রদান করে যা অনুসন্ধান ক্যোয়ারির সাথে মেলে৷ ক্যোয়ারীটি পরিচিতির names , nickNames , emailAddresses , phoneNumbers , এবং organizations ক্ষেত্রগুলির সাথে মেলে যা CONTACT উত্স থেকে এসেছে৷
গুরুত্বপূর্ণ : অনুসন্ধান করার আগে, ক্লায়েন্টদের ক্যাশে আপডেট করার জন্য একটি খালি ক্যোয়ারী সহ একটি ওয়ার্মআপ অনুরোধ পাঠাতে হবে। https://developers.google.com/people/v1/contacts#search_the_users_contacts দেখুন
HTTP অনুরোধ
GET https://people.googleapis.com/v1/people:searchContacts
URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।
ক্যোয়ারী প্যারামিটার
| পরামিতি | |
|---|---|
query | প্রয়োজন। অনুরোধের জন্য প্লেইন-টেক্সট ক্যোয়ারী। ক্যোয়ারীটি একজন ব্যক্তির ক্ষেত্রে ক্ষেত্রগুলির উপসর্গের বাক্যাংশগুলিকে মেলানোর জন্য ব্যবহৃত হয়। উদাহরণস্বরূপ, "foo name" নামের একজন ব্যক্তি "f", "fo", "foo", "foo n", "nam" ইত্যাদির মতো প্রশ্নের সাথে মেলে, কিন্তু "oo n" নয়। |
pageSize | ঐচ্ছিক। ফলাফলের সংখ্যা। ক্ষেত্র সেট না থাকলে ডিফল্ট 10, বা 0 এ সেট করা হয়। 30-এর বেশি মান 30-এ সীমাবদ্ধ করা হবে। |
readMask | প্রয়োজন। প্রতিটি ব্যক্তির কোন ক্ষেত্রগুলি ফেরত দেওয়া হবে তা সীমাবদ্ধ করার জন্য একটি ফিল্ড মাস্ক৷ একাধিক ক্ষেত্র কমা দিয়ে আলাদা করে নির্দিষ্ট করা যেতে পারে। বৈধ মান হল:
|
sources[] | ঐচ্ছিক। কোন উৎসের ধরন ফেরাতে হবে তার একটি মুখোশ। সেট না থাকলে |
শরীরের অনুরোধ
অনুরোধের বডি খালি হতে হবে।
প্রতিক্রিয়া শরীর
সফল হলে, প্রতিক্রিয়া বডিতে SearchResponse এর একটি উদাহরণ থাকে।
অনুমোদনের সুযোগ
নিম্নলিখিত OAuth সুযোগগুলির মধ্যে একটি প্রয়োজন:
-
https://www.googleapis.com/auth/contacts -
https://www.googleapis.com/auth/contacts.readonly
আরও তথ্যের জন্য, অনুমোদন নির্দেশিকা দেখুন।