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

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

به‌روزرسانی یک مخاطب مشترک

هنگام به‌روزرسانی یک ورودی، تمام XML بازیابی شده از سرور را حفظ کنید. در غیر این صورت، عناصر نادیده گرفته شده حذف می‌شوند. به‌روزرسانی‌ها می‌توانند تا ۲۴ ساعت طول بکشند تا در تکمیل خودکار و مدیریت تماس منعکس شوند.

برای به‌روزرسانی یک مخاطب مشترک موجود:

1. ورودی را برای به‌روزرسانی دریافت کنید .
2. ورودی را ویرایش کنید.

3. یک درخواست PUT با ورودی به‌روزرسانی‌شده به آدرس ویرایش مخاطب ارسال کنید. از نوع محتوای application/atom+xml استفاده کنید و مطمئن شوید که مقدار <id> دقیقاً با ورودی موجود مطابقت دارد. آدرس ویرایش با یک شماره نسخه به پایان می‌رسد تا تداخل‌ها تشخیص داده شوند. برای اطلاعات بیشتر، به بخش نسخه‌بندی مراجعه کنید.

   ورودی را به‌روزرسانی کنید:

   <entry>
     <id>https://www.google.com/m8/feeds/contacts/DOMAIN/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>TITLE_NAME</title>
     <gd:name>
       <gd:fullName>FIRST_NAME LAST_NAME</gd:fullName>
     </gd:name>
     <content type='text'>NOTES</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>PRIMARY_PHONE_NUMBER</gd:phoneNumber>
     <gd:extendedProperty name="CUSTOM_PROPERTY" value="CUSTOM_PROPRTY_VALUE" />
   </entry>

   موارد زیر را جایگزین کنید:

   • DOMAIN : دامنه شما - برای مثال، example.com.
   • TITLE_NAME : نامی برای ورودی - برای مثال، لیست مخاطبین example.com.
   • FIRST_NAME : نام کوچک مخاطب.
   • نام LAST_NAME : نام خانوادگی مخاطب.
   • PROJECTION : مقدار تصویر. برای مقادیر پشتیبانی شده، به مقادیر تصویر مراجعه کنید.
   • PRIMARY_PHONE_NUMBER : شماره تلفن ترجیحی.
   • CUSTOM_PROPERTY : نامی برای یک ویژگی سفارشی.

   • CUSTOM_PROPRTY_VALUE : مقدار برای یک ویژگی سفارشی.

     مثالی از ورودی به‌روزرسانی‌شده با آدرس ویرایش هایلایت‌شده:

     <entry>
     <id>https://www.google.com/m8/feeds/contacts/example.com/base/8411573</id>
     <updated>2008-02-28T18:47:02.303Z</updated>
     <category scheme='http://schemas.google.com/g/2005#kind'
       term='http://schemas.google.com/contact/2008#contact' />
     <title type='text'>Fitzgerald</title>
     <gd:name>
       <gd:fullName>Fitzgerald</gd:fullName>
     </gd:name>
     <content type='text'>Notes</content>
     <link rel='self' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573' />
     <link rel='edit' type='application/atom+xml'
       href='https://www.google.com/m8/feeds/contacts/example.com/full/8411573/1204224422303000' />
     <gd:phoneNumber rel='http://schemas.google.com/g/2005#other'
       primary='true'>456-123-2133</gd:phoneNumber>
     <gd:extendedProperty name="pet" value="hamster" />
     <gd:extendedProperty name="cuisine">
       <italian />
     </gd:extendedProperty>
     </entry>

حذف مخاطبین مشترک

مخاطبین حذف شده ممکن است تا ۲۴ ساعت طول بکشد تا از حالت تکمیل خودکار و مدیریت مخاطبین حذف شوند. مخاطبین را با حذف و اضافه کردن مجدد به‌روزرسانی نکنید. در عوض، به بخش به‌روزرسانی مخاطبین مراجعه کنید.

• برای حذف یک مخاطب مشترک، یک درخواست DELETE به آدرس ویرایش مخاطب ارسال کنید. این همان آدرسی است که برای به‌روزرسانی مخاطبین استفاده می‌شود.

گوگل به مدت ۳۰ روز مکان‌نماهای مربوط به مخاطبین حذف شده را نگه می‌دارد. برای درخواست آنها از پارامتر پرس‌وجوی showdeleted استفاده کنید.

مراحل بعدی

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