نمایندگان تماس را مدیریت کنید

این راهنما نحوه ایجاد، فهرست کردن و حذف نمایندگان مخاطب برای کاربران Google Workspace را پوشش می‌دهد.

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

این راهنما برای واگذاری دسترسی به مخاطبین است. برای واگذاری دسترسی به Gmail، به بخش واگذاری و همکاری در ایمیل مراجعه کنید.

پیش‌نیازها

قبل از استفاده از API نمایندگی تماس، مطمئن شوید که شرایط زیر را دارید:

• فعال کردن اشتراک‌گذاری مخاطبین : مدیر دایرکتوری باید اشتراک‌گذاری مخاطبین را در کنسول مدیریت فعال کند. برای اطلاعات بیشتر، به روشن یا خاموش کردن اشتراک‌گذاری مخاطبین مراجعه کنید.
• امتیازات مدیر : برای مدیریت نمایندگان سایر کاربران، باید امتیاز مدیر «مخاطبین» را داشته باشید.
• محدودیت دامنه : شما فقط می‌توانید مخاطبین را بین کاربرانی که در یک سازمان Google Workspace یکسان هستند، واگذار کنید.
• دامنه OAuth : برنامه شما باید از دامنه OAuth زیر استفاده کند: https://www.googleapis.com/auth/admin.contact.delegation .

ایجاد نماینده

برای ایجاد نماینده برای یک کاربر، یک درخواست POST با آدرس ایمیل نماینده ارسال کنید:

POST https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

به جای USER_EMAIL آدرس ایمیل نماینده را قرار دهید.

در بدنه درخواست، آدرس ایمیل نماینده را ارائه دهید:

{
  "email": "DELEGATE_EMAIL"
}

به جای DELEGATE_EMAIL آدرس ایمیل نماینده را قرار دهید.

یک پاسخ موفقیت‌آمیز، کد وضعیت HTTP 200 و ایمیل نماینده جدید را برمی‌گرداند:

{
  "email": "DELEGATE_EMAIL"
}

لیست نمایندگان

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

GET https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates

به جای USER_EMAIL آدرس ایمیل کاربر را قرار دهید.

یک پاسخ موفق، کد وضعیت HTTP 200 و لیستی از ایمیل‌های نماینده را برمی‌گرداند:

{
  "delegates": [
    {
      "email": "DELEGATE_EMAIL_1"
    },
    {
      "email": "DELEGATE_EMAIL_2"
    }
  ]
}

حذف یک نماینده

برای حذف نماینده برای مخاطبین یک کاربر، این مراحل را انجام دهید:

1. نماینده‌ای را که می‌خواهید حذف کنید، شناسایی کنید. از متد List delegates برای یافتن آدرس ایمیل یک نماینده خاص استفاده کنید.

2. یک درخواست DELETE با آدرس‌های ایمیل نماینده و نماینده ارسال کنید:

   DELETE https://admin.googleapis.com/admin/contacts/v1/users/USER_EMAIL/delegates/DELEGATE_EMAIL
   

به جای USER_EMAIL آدرس ایمیل نماینده و به جای DELEGATE_EMAIL آدرس ایمیل نماینده را قرار دهید.

یک پاسخ موفق، کد وضعیت HTTP 200 را برمی‌گرداند.