این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

به طور پیش‌فرض، ورودی‌های یک فید نامرتب هستند.

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

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

GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION

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

DOMAIN : دامنه شما. به عنوان مثال، example.com.
PROJECTION : مقدار تصویر. برای مقادیر پشتیبانی شده، به مقادیر تصویر مراجعه کنید.

سرور یک کد وضعیت HTTP 200 OK و یک فید Atom 1.0 برمی‌گرداند. مثال زیر یک فید مخاطبین با یک ورودی را نشان می‌دهد:

<feed xmlns='http://www.w3.org/2005/Atom'
    xmlns:openSearch='http://a9.com/-/spec/opensearchrss/1.0/'
    xmlns:gd='http://schemas.google.com/g/2005'
    xmlns:gContact='http://schemas.google.com/contact/2008'
    xmlns:batch='http://schemas.google.com/gdata/batch'>
  <id>https://www.google.com/m8/feeds/contacts/example.com/base</id>
  <updated>2008-03-05T12:36:38.836Z</updated>
  <category scheme='http://schemas.google.com/g/2005#kind'
    term='http://schemas.google.com/contact/2008#contact' />
  <title type='text'>example.com's Contacts</title>
  <link rel='http://schemas.google.com/g/2005#feed'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#post'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full' />
  <link rel='http://schemas.google.com/g/2005#batch'
    type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full/batch' />
  <link rel='self' type='application/atom+xml'
    href='https://www.google.com/m8/feeds/contacts/example.com/full?max-results=25' />
  <author>
    <name>example.com</name>
    <email>example.com</email>
  </author>
  <generator version='1.0' uri='https://www.google.com/m8/feeds/contacts'>
    Contacts
  </generator>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>25</openSearch:itemsPerPage>
  <entry>
    <id>
      https://www.google.com/m8/feeds/contacts/example.com/base/c9012de
    </id>
    <updated>2008-03-05T12:36:38.835Z</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>
    <link rel="http://schemas.google.com/contacts/2008/rel#photo" type="image/*"
      href="http://google.com/m8/feeds/photos/media/example.com/c9012de"/>
    <link rel='self' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de' />
    <link rel='edit' type='application/atom+xml'
      href='https://www.google.com/m8/feeds/contacts/example.com/full/c9012de/1204720598835000' />
    <gd:phoneNumber rel='http://schemas.google.com/g/2005#home'
      primary='true'>
      456
    </gd:phoneNumber>
    <gd:extendedProperty name="pet" value="hamster" />
  </entry>
</feed>

فیدها حداکثر 10 مگابایت را در یک پاسخ برمی‌گردانند. برای دریافت کل لیست، بارها و بارها لینک بعدی را در فید برگشتی دنبال کنید.

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

درخواست مخاطبینی که با معیارهای مشخص‌شده مطابقت دارند، مانند مخاطبینی که پس از یک تاریخ خاص به‌روزرسانی شده‌اند. پرس‌وجوهای متن کامل و جستجوی آدرس ایمیل پشتیبانی نمی‌شوند. برای مشاهده‌ی تمام پارامترهای پرس‌وجو، به راهنمای مرجع API مخاطبین مشترک دامنه مراجعه کنید.

یک درخواست HTTP GET به آدرس فید مخاطبین با یک پارامتر ارسال کنید:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION?PARAMETER
```
موارد زیر را جایگزین کنید:
- DOMAIN : دامنه شما - برای مثال، example.com.
- PROJECTION : مقدار تصویر. برای مقادیر پشتیبانی شده، به مقادیر تصویر مراجعه کنید.
- PARAMETER : یک پارامتر پرس‌وجوی پشتیبانی‌شده. به راهنمای مرجع API مربوط به مخاطبین مشترک دامنه مراجعه کنید.
برای مثال، برای به‌روزرسانی ورودی‌ها پس از ۱۶ مارس ۲۰۲۲ برای example.com، پارامتر updated-min را اضافه کنید:
```
GET https://www.google.com/m8/feeds/contacts/example.com/full?updated-min=2022-03-16T00:00:00
```
سرور یک کد وضعیت HTTP 200 OK و یک فید با هرگونه تطابق را برمی‌گرداند.
فیدها حداکثر 10 مگابایت را در یک پاسخ برمی‌گردانند. برای دریافت کل لیست، بارها و بارها لینک بعدی را در فید برگشتی دنبال کنید.

پیگیری تغییرات تدریجی

برای ردیابی تغییرات در لیست مخاطبین مشترک یک دامنه: ۱. مقدار عنصر <updated> فید را ثبت کنید. ۱. با تنظیم updated-min روی آن مقدار <updated> و تنظیم showdeleted روی true ، مخاطبین تغییر یافته را درخواست کنید.

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

برای دریافت یک مخاطب خاص، از لینک شخصی آن مخاطب استفاده کنید که می‌توانید آن را در فید مخاطبین مشترک پیدا کنید. برای اطلاعات بیشتر، به دریافت همه مخاطبین مشترک مراجعه کنید.

برای دریافت یک مخاطب خاص، یک درخواست HTTP GET به لینک شخصی مخاطب ارسال کنید:
```
GET https://www.google.com/m8/feeds/contacts/DOMAIN/PROJECTION/SELF_LINK
```
موارد زیر را جایگزین کنید:

DOMAIN : دامنه شما - برای مثال، example.com.
PROJECTION : مقدار تصویر. برای مقادیر پشتیبانی شده، به مقادیر تصویر مراجعه کنید.
SELF_LINK : مقدار عددی منحصر به فرد مخاطب.

سرور کد وضعیت HTTP 200 OK و ورودی مخاطب را برمی‌گرداند.

برای مثال، برای دریافت یک مخاطب با لینک شخصی https://www.google.com/m8/feeds/contacts/example.com/full/12345 :

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

مراحل بعدی

برای یک مخاطب مشترک عکس بگیرید

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