با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
Domain Shared Contacts API به برنامه‌های شما اجازه می‌دهد مخاطبین خارجی را که با همه کاربران در یک دامنه Google Workspace به اشتراک گذاشته شده‌اند، دریافت و به‌روزرسانی کنند. مخاطبین به اشتراک گذاشته شده برای همه کاربران یک دامنه Google Workspace قابل مشاهده است و همه سرویس های Google به لیست مخاطبین دسترسی دارند.
برنامه شما می تواند از Domain Shared Contacts API برای ایجاد مخاطبین به اشتراک گذاشته شده، ویرایش یا حذف مخاطبین به اشتراک گذاشته شده موجود، و پرس و جو برای مخاطبین به اشتراک گذاشته شده که با معیارهای خاصی مطابقت دارند استفاده کند.
Domain Shared Contacts API فقط برای حساب‌های Google Workspace در دسترس است. برای استفاده از API، Domain Shared Contacts API را در کنسول مدیریت فعال کنید . تغییرات مخاطب مشترک ممکن است تا 24 ساعت طول بکشد تا در تکمیل خودکار آدرس ایمیل و مدیر تماس منعکس شود.
این سند علاوه بر ارائه پس‌زمینه درباره قابلیت‌های Domain Shared Contacts API، مثال‌هایی درباره نحوه مدیریت مخاطبین با استفاده از XML و HTTP ارائه می‌دهد. پس از خواندن این سند، می توانید با استفاده از کتابخانه های سرویس گیرنده ما درباره تعامل با API اطلاعات بیشتری کسب کنید.
مخاطب
این سند برای توسعه دهندگانی در نظر گرفته شده است که می خواهند برنامه های مشتری بنویسند که می توانند لیست مخاطبین Google را با استفاده از HTTP و XML دستکاری کنند. این سند فرض می‌کند که شما اصول اولیه پروتکل Google Data APIs را درک می‌کنید.
اگر از سیستم عامل یونیکس استفاده می کنید و می خواهید نمونه های این سند را بدون نوشتن هیچ کدی امتحان کنید، از ابزارهای خط فرمان یونیکس curl یا wget استفاده کنید. نحوه استفاده از cURL با خدمات Google Data را بیاموزید.
اصول
این نسخه از Domain Shared Contacts API از اصول Google Data API پیروی می کند. APIهای Google Data علاوه بر پروتکل انتشار اتم بر اساس هر دو فرمت سندیکای Atom 1.0 و RSS 2.0 هستند.
یک نسخه را مشخص کنید
هر درخواستی که با استفاده از Domain Shared Contacts API ارسال می‌کنید باید نسخه 3.0 API را مشخص کند:
GData-Version: 3.0
اگر نمی توانید سرصفحه های HTTP را تنظیم کنید، می توانید v=3.0 را به عنوان پارامتر پرس و جو در URL تعیین کنید، اما روش هدر HTTP توصیه می شود.
تاریخ آخرین به‌روزرسانی 2025-03-25 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-03-25 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Domain Shared Contacts API overview\n\nThe Domain Shared Contacts API lets your applications get and update external\ncontacts that are shared with all users in a Google Workspace domain. Shared\ncontacts are visible to all users of a Google Workspace domain and all Google\nservices have access to the contact list.\n| **Warning:** The Domain Shared Contacts API is intended only for *external* contacts. Using this API to create contact information for domain (internal) users or groups can result in duplicate contact information for those users and groups, which might lead to unexpected behavior. To get and update Google Workspace domain (internal) users' contact information, use the [Directory API](https://developers.google.com/workspace/admin/directory) instead.\n\nYour application can use the Domain Shared Contacts API to create shared contacts, edit\nor delete existing shared contacts, and query for shared contacts that match a\nparticular criteria.\n\nThe Domain Shared Contacts API is only available to Google Workspace accounts.\nTo use the API,\n[enable the Domain Shared Contacts API in the Admin console](https://support.google.com/a/answer/60757).\nShared contact changes can take up to 24 hours to be reflected in the email\naddress autocomplete and the contact manager.\n\nIn addition to providing background on the capabilities of the\nDomain Shared Contacts API, this document offers examples about how to manage\ncontacts by using XML and HTTP. After reading this document, you can learn more\nabout interacting with the API by using our\n[client libraries](https://developers.google.com/api-client-library).\n\nAudience\n--------\n\nThis document is intended for developers who want to write client applications\nthat can manipulate Google's contact lists by using HTTP and XML.\nThis document assumes that you understand the\n[fundamentals behind the Google Data APIs protocol](https://developers.google.com/gdata/docs/2.0/basics).\n\nIf you're using a UNIX operating system and you want to try the examples in this\ndocument without writing any code, use the UNIX command-line utilities\n[curl](https://curl.haxx.se/)\nor\n[wget](https://www.gnu.org/software/wget/).\nLearn how to\n[use cURL with Google Data services](https://developers.google.com/gdata/articles/using_cURL).\n\nPrinciples\n----------\n\nThis version of the Domain Shared Contacts API follows the principles of the\n[Google Data APIs](https://developers.google.com/gdata/docs/developers-guide).\nGoogle Data APIs are based on both the Atom 1.0 and RSS 2.0 syndication formats\nin addition to the Atom Publishing Protocol.\n\nSpecify a version\n-----------------\n\nEvery request that you send using the Domain Shared Contacts API should specify version\n3.0 of the API: \n\n GData-Version: 3.0\n\nIf you can't set HTTP headers, you can specify`v=3.0` as a query parameter in\nthe URL, but the HTTP header method is recommended.\n| **Note:** The client libraries supply appropriate version headers automatically, so don't use the `v=3.0` query parameter when you're using a client library."]]
