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

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

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

   <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 : نام کوچک مخاطب، مانند Dana.
   • LAST_NAME : نام خانوادگی مخاطب، مانند A.
   • PRIMARY_EMAIL_ADDRESS : آدرس ایمیل ترجیحی، مانند [e-mail].
   • PREFERRED_NAME : نام نمایشی برای کاربر، مانند Dana A.
   • SECONDARY_EMAIL_ADDRESS : ایمیل ثانویه، مانند [e-mail].
   • PRIMARY_PHONE_NUMBER : شماره تلفن ترجیحی، مانند ۸۰۰-۵۵۵-۰۱۰۰.
   • SECONDARY_PHONE_NUMBER : شماره تلفن ثانویه، مانند ۸۰۰-۵۵۵-۰۱۰۱.
   • INSTANT_MESSAGING_ADDRESS : آدرس ایمیل پیام‌رسانی فوری، مانند [e-mail].
   • CITY_NAME : نام شهر، مانند Mountain View.
   • ADDRESS : آدرس خیابان، مانند بلوار آمفیبیوس ۱۸۰۰
   • REGION_NAME : ایالت یا استان، مانند CA.
   • POST_CODE : کد پستی یا ZIP، مانند ۹۴۰۴۵.
   • COUNTRY_NAME : کشور، مانند ایالات متحده آمریکا.
   • FORMATTED_ADDRESS : آدرس با استفاده از قراردادهای محلی قالب‌بندی شده است، مانند ۱۸۰۰ Amphibious Blvd., Mountain View, CA 94045, USA.

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

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

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

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

   سرور مخاطب را ایجاد می‌کند و یک کد وضعیت HTTP 201 CREATED را به همراه ورودی جدید مخاطب برمی‌گرداند. ورودی برگردانده شده شامل عناصر تولید شده توسط سرور مانند <id> است.

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

مراحل بعدی

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