শেয়ার করা পরিচিতি তৈরি করুন

প্রমাণীকরণ সেট-আপ করার পরে, আপনি Google Workspace ডোমেনে নতুন শেয়ার করা পরিচিতি এন্ট্রি প্রকাশ করতে ডোমেন শেয়ার করা পরিচিতি API ব্যবহার করতে পারেন। শেয়ার করা পরিচিতিগুলি স্বয়ংসম্পূর্ণ ইমেল ঠিকানা এবং পরিচিতি পরিচালকে প্রদর্শিত হতে 24 ঘন্টা পর্যন্ত সময় নিতে পারে৷

1. ভাগ করা পরিচিতির একটি XML উপস্থাপনা তৈরি করুন যা আপনি পরিচিতির প্রকারের একটি Atom <entry> উপাদানের আকারে প্রকাশ করতে চান, যা নিম্নলিখিতগুলির মতো দেখতে হতে পারে:

   <atom:entry xmlns:atom='http://www.w3.org/2005/Atom'
       xmlns:gd='http://schemas.google.com/g/2005'>
     <atom:category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <gd:name>
        <gd:givenName>FIRST_NAME</gd:givenName>
        <gd:familyName>LAST_NAME</gd:familyName>
        <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <atom:content type='text'>NOTES</atom:content>
     <gd:email rel='http://schemas.google.com/g/2005#work'
       primary='true'
       address='PRIMARY_EMAIL_ADDRESS' displayName='PREFERRED_NAME' />
     <gd:email rel='http://schemas.google.com/g/2005#home'
       address='SECONDARY_EMAIL_ADDRESS' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#work'
       primary='true'>
       PRIMARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'>
       SECONDARY_PHONE_NUMBER
     </gd:phoneNumber>
     <gd:im address='INSTANT_MESSAGING_ADDRESS'
       protocol='http://schemas.google.com/g/2005#GOOGLE_TALK'
       primary='true'
       rel='http://schemas.google.com/g/2005#home' />
     <gd:structuredPostalAddress
         rel='http://schemas.google.com/g/2005#work'
         primary='true'>
       <gd:city>CITY_NAME</gd:city>
       <gd:street>ADDRESS</gd:street>
       <gd:region>REGION_NAME</gd:region>
       <gd:postcode>POST_CODE</gd:postcode>
       <gd:country>COUNTRY_NAME</gd:country>
       <gd:formattedAddress>
         FORMATTED_ADDRESS
       </gd:formattedAddress>
     </gd:structuredPostalAddress>
   </atom:entry>
   

   নিম্নলিখিতগুলি প্রতিস্থাপন করুন:

   • FIRST_NAME : ভাগ করা পরিচিতির প্রথম নাম—উদাহরণস্বরূপ, অ্যালেক্স।
   • LAST_NAME : ভাগ করা পরিচিতির শেষ নাম—উদাহরণস্বরূপ, কিম।
   • PRIMARY_EMAIL_ADDRESS : শেয়ার করা পরিচিতির পছন্দের ইমেল ঠিকানা—উদাহরণস্বরূপ, [e-mail]।
   • PREFERRED_NAME : ব্যবহারকারীর জন্য প্রদর্শিত নাম—উদাহরণস্বরূপ, অ্যালেক্স কিম
   • SECONDARY_EMAIL_ADDRESS : শেয়ার করা পরিচিতির জন্য আরেকটি ইমেল ঠিকানা—উদাহরণস্বরূপ, [e-mail]।
   • PRIMARY_PHONE_NUMBER : ভাগ করা পরিচিতির জন্য পছন্দের ফোন নম্বর—উদাহরণস্বরূপ, [phone]৷
   • SECONDARY_PHONE_NUMBER : শেয়ার করা পরিচিতির জন্য আরেকটি ফোন নম্বর—উদাহরণস্বরূপ, [phone]।
   • INSTANT_MESSAGING_ADDRESS : শেয়ার করা পরিচিতির ইনস্ট্যান্ট মেসেজিং তথ্যের সাথে যুক্ত ইমেল ঠিকানা—উদাহরণস্বরূপ, [e-mail]।
   • CITY_NAME : শেয়ার করা পরিচিতির জন্য শহরের নাম—উদাহরণস্বরূপ, মাউন্টেন ভিউ।
   • ADDRESS : শেয়ার করা পরিচিতির রাস্তার ঠিকানা—উদাহরণস্বরূপ, 1600 অ্যাম্ফিবিয়াস ব্লভিডি।
   • REGION_NAME : শেয়ার করা পরিচিতির জন্য রাজ্য বা প্রদেশ—উদাহরণস্বরূপ, CA।
   • POST_CODE : শেয়ার করা পরিচিতির জন্য জিপ বা পোস্টাল কোড—উদাহরণস্বরূপ, 94045।
   • COUNTRY_NAME : শেয়ার করা পরিচিতির দেশ—উদাহরণস্বরূপ, মার্কিন যুক্তরাষ্ট্র।
   • FORMATTED_ADDRESS : ভাগ করা পরিচিতির ঠিকানা যা তাদের দেশ বা অঞ্চলের কনভেনশন ব্যবহার করে ফর্ম্যাট করা হয়েছে—উদাহরণস্বরূপ, 1800 অ্যাম্ফিবিয়াস ব্লভিডি মাউন্টেন ভিউ৷

2. এই এন্ট্রি প্রকাশ করতে, এটি পরিচিতি-তালিকা ফিড URL এ পাঠান:

   1. application/atom+xml কন্টেন্ট টাইপ ব্যবহার করে একটি নতুন POST অনুরোধের বডিতে আপনার Atom <entry> উপাদান রাখুন।
   2. ফিড URL-এ POST অনুরোধ পাঠান।

   উদাহরণস্বরূপ, example.com-এর তালিকায় একটি ডোমেন শেয়ার করা পরিচিতি যোগ করতে, নিম্নলিখিত URL-এ নতুন এন্ট্রি সহ POST অনুরোধ পাঠান:

   https://www.google.com/m8/feeds/contacts/example.com/full
   

   Google সার্ভার আপনার পাঠানো এন্ট্রি ব্যবহার করে একটি পরিচিতি তৈরি করে, তারপর একটি <entry> উপাদানের আকারে নতুন পরিচিতির একটি অনুলিপি সহ একটি HTTP 201 CREATED স্ট্যাটাস কোড ফেরত দেয়। ফেরত দেওয়া এন্ট্রিটি আপনার পাঠানো একই, তবে এতে সার্ভারের দ্বারা যোগ করা বিভিন্ন উপাদান রয়েছে, যেমন একটি <id> উপাদান।

   আপনার অনুরোধ ব্যর্থ হলে, Google একটি ভিন্ন স্ট্যাটাস কোড ফেরত দিতে পারে। স্ট্যাটাস কোড সম্পর্কে তথ্যের জন্য, Google Data API প্রোটোকল রেফারেন্স ডকুমেন্ট দেখুন।

পরবর্তী পদক্ষেপ

• একটি শেয়ার করা পরিচিতির জন্য একটি ফটো আপডেট করুন বা মুছুন৷