শেয়ার করা পরিচিতি উপাদান

ডোমেইন শেয়ার্ড কন্ট্যাক্টস এপিআই স্ট্যান্ডার্ড গুগল ডেটা এপিআই এলিমেন্ট এবং শেয়ার্ড কন্ট্যাক্টসের জন্য নির্দিষ্ট এলিমেন্টগুলো ব্যবহার করে।

একটি কন্টাক্ট এন্ট্রি একটি এক্সটেন্ডেড কন্টাক্ট কাইন্ডের রূপ নেয়, যা একজন ব্যক্তি, একটি স্থান—যেমন একটি ক্লাব বা রেস্তোরাঁ—অথবা একটি সংস্থাকে প্রতিনিধিত্ব করে। কন্টাক্ট কাইন্ডটি XML-এ একটি <atom:entry> এলিমেন্ট হিসেবে প্রদর্শিত হয়, যার মধ্যে Google Data নেমস্পেসের বিভিন্ন এক্সটেনশন এলিমেন্ট থাকে।

এন্ট্রিটি যে একটি কন্টাক্ট, তা নির্দেশকারী category এলিমেন্টটি দেখতে নিম্নলিখিতের মতো:

<atom:category scheme="http://schemas.google.com/g/2005#kind"
  term="http://schemas.google.com/contact/2008#contact"/>

ডোমেইন শেয়ার্ড কন্টাক্টস এপিআই-তে, কয়েকটি এলিমেন্ট ‘কন্টাক্ট কাইন্ড’-এর চেয়ে কিছুটা বেশি সীমাবদ্ধ। নিম্নলিখিত এলিমেন্টগুলোর জন্য, আপনাকে হয় একটি rel অ্যাট্রিবিউট অথবা একটি label অ্যাট্রিবিউট সরবরাহ করতে হবে, কিন্তু উভয়ই নয়:

  • gd:email
  • gd:im
  • gd:organization
  • gd:phoneNumber
  • gd:structuredPostalAddress

যখন আপনি কোনো শেয়ার করা কন্ট্যাক্ট তৈরি বা আপডেট করেন, তখন যদি আপনি rel ও label উভয় এলিমেন্টের জন্য দুটোই দেন, অথবা কোনোটিই না দেন, তাহলে সার্ভার সেই এন্ট্রিটি প্রত্যাখ্যান করে।

ফটো সমর্থন

`self` বা `edit`-এর মতো স্ট্যান্ডার্ড প্রপার্টির ভ্যালুগুলোর পাশাপাশি, আপনি atom:link এলিমেন্টের জন্য rel ভ্যালুও ব্যবহার করতে পারেন। ফটো লিঙ্ক ব্যবহার করার সময়, HTTP হেডারে অথরাইজেশন টোকেন উল্লেখ করতে হবে। আরও তথ্যের জন্য, `authentication and authorization` সম্পর্কে জানুন ।

  • GET কমান্ডের ক্ষেত্রে, rel="http://schemas.google.com/contacts/2008/rel#photo" ব্যবহার করলে কন্ট্যাক্টটির সাথে যুক্ত ছবিটি পড়ার সুবিধা যোগ হয়। কন্ট্যাক্টটির সাথে যুক্ত ছবির সর্বশেষ সংস্করণটি পড়ার জন্য আপনি href এ নির্দিষ্ট করা URL-টি ব্যবহার করতে পারেন। কন্ট্যাক্টটির কোনো ছবি না থাকলে লিঙ্কটি দেখানো হয় না।

উদাহরণ:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234" type="image/*" />
  • PUT বা DELETE কমান্ডের সাথে, rel="http://schemas.google.com/contacts/2008/rel#edit-photo" ব্যবহার করে কন্ট্যাক্টটির সাথে যুক্ত স্থানীয় কোনো ছবি আপডেট বা ডিলিট করার সুবিধা যোগ করা হয়।

উদাহরণ:

<atom:link rel="http://schemas.google.com/contacts/2008/rel#edit-photo"
           href="https://www.google.com/m8/feeds/photos/media/jo%40example.com/1234/photo4524" />

gContact নেমস্পেস

gContact জন্য XML নেমস্পেস URL হলো http://schemas.google.com/contact/2008 ।

এই নেমস্পেসে এমন একটি এলিমেন্ট সংজ্ঞায়িত করা হয়েছে, যা সেই গ্রুপটিকে প্রতিনিধিত্ব করে যার অন্তর্ভুক্ত কন্টাক্টটি।

gContact:groupMembershipInfo প্রোপার্টি

সম্পত্তি বর্ণনা
href যোগাযোগকারী ব্যক্তিটি কোন গ্রুপের সদস্য বা পূর্বে সদস্য ছিলেন, তা শনাক্ত করে। গ্রুপটিকে তার আইডি দ্বারা উল্লেখ করা হয়।
deleted="true" এর অর্থ হলো কন্ট্যাক্টটির জন্য গ্রুপ মেম্বারশিপটি সরিয়ে ফেলা হয়েছে। এই অ্যাট্রিবিউটটি শুধুমাত্র তখনই অন্তর্ভুক্ত করা হয় যখন কোয়েরি প্যারামিটার হিসেবে showdeleted নির্দিষ্ট করা থাকে; অন্যথায়, কোনো কন্ট্যাক্ট যেসব গ্রুপের আর সদস্য নয়, সেগুলোর জন্য groupMembershipInfo ফেরত দেওয়া হয় না।