ایجاد مخاطبین مشترک

پس از راه‌اندازی احراز هویت ، می‌توانید از Domain Shared Contacts API برای انتشار ورودی‌های تماس مشترک جدید در دامنه Google Workspace استفاده کنید. ممکن است تا 24 ساعت طول بکشد تا مخاطبین مشترک در تکمیل خودکار آدرس ایمیل و مدیر تماس ظاهر شوند.

1. یک نمایش XML از مخاطب مشترکی که می‌خواهید منتشر کنید به شکل یک عنصر Atom <entry> از نوع Contact ایجاد کنید، که ممکن است شبیه موارد زیر باشد:

   <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 : نام مخاطب مشترک - برای مثال Alex.
   • LAST_NAME : نام خانوادگی مخاطب مشترک—مثلاً کیم.
   • PRIMARY_EMAIL_ADDRESS : آدرس ایمیل ترجیحی مخاطب مشترک - برای مثال، [e-mail].
   • PREFERRED_NAME : نامی که برای کاربر نمایش داده می‌شود - برای مثال Alex Kim
   • SECONDARY_EMAIL_ADDRESS : آدرس ایمیل دیگری برای مخاطب مشترک - به عنوان مثال، [e-mail].
   • PRIMARY_PHONE_NUMBER : شماره تلفن ترجیحی برای مخاطب مشترک - برای مثال، [phone].
   • SECONDARY_PHONE_NUMBER : شماره تلفن دیگری برای مخاطب مشترک - به عنوان مثال، [phone].
   • INSTANT_MESSAGING_ADDRESS : آدرس ایمیل مرتبط با اطلاعات پیام‌رسانی فوری مخاطب مشترک - برای مثال، [e-mail].
   • CITY_NAME : نام شهر برای مخاطب مشترک—مثلاً Mountain View.
   • ADDRESS : آدرس خیابان مخاطب مشترک - برای مثال، 1600 Amphibious Blvd.
   • REGION_NAME : ایالت یا استان برای مخاطب مشترک - برای مثال، CA.
   • POST_CODE : کد پستی یا کد پستی مخاطب مشترک - برای مثال، 94045.
   • COUNTRY_NAME : کشور مخاطب مشترک—مثلاً ایالات متحده.
   • FORMATTED_ADDRESS : آدرس مخاطب مشترکی که با استفاده از قرارداد کشور یا منطقه آنها قالب‌بندی شده است - برای مثال، نمای کوهستانی بلوار دوزیستان 1800.

2. برای انتشار این ورودی، آن را به نشانی اینترنتی فید فهرست مخاطبین ارسال کنید:

   1. عنصر <entry> Atom خود را با استفاده از نوع محتوای application/atom+xml در متن درخواست POST جدید قرار دهید.
   2. درخواست POST را به URL فید ارسال کنید.

   به عنوان مثال، برای افزودن یک مخاطب مشترک دامنه به لیست متعلق به example.com، درخواست POST را با ورودی جدید به URL زیر ارسال کنید:

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

   سرور Google یک مخاطب را با استفاده از ورودی ارسالی شما ایجاد می کند، سپس یک کد وضعیت HTTP 201 CREATED را به همراه یک کپی از مخاطب جدید به شکل عنصر <entry> برمی گرداند. ورودی بازگشتی همان ورودی است که شما ارسال کرده اید، اما حاوی عناصر مختلفی است که توسط سرور اضافه شده است، مانند عنصر <id> .

   اگر درخواست شما ناموفق باشد، ممکن است Google کد وضعیت دیگری را برگرداند. برای اطلاعات در مورد کدهای وضعیت، به سند مرجع پروتکل Google Data API مراجعه کنید.

مراحل بعدی

• عکسی را برای یک مخاطب مشترک به‌روزرسانی یا حذف کنید