یک کاربر ایجاد میکند که به یک دامنه دسترسی دارد. اگر کاربری ارائه نشود، INVALID_ARGUMENT را برمیگرداند.
درخواست HTTP
POST https://gmailpostmastertools.googleapis.com/v2beta/{parent=domains/*}/users
این URL از سینتکس Transcoding در gRPC استفاده میکند.
پارامترهای مسیر
| پارامترها | |
|---|---|
parent | الزامی. منبع والد که این کاربر در آن ایجاد خواهد شد. فرمت: domains/{domain} |
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{
"userId": string,
"permission": enum ( |
| فیلدها | |
|---|---|
userId | الزامی. کاربری که باید ایجاد کند. |
permission | اختیاری. سطح دسترسی که کاربر برای دامنه مشخص شده باید داشته باشد را مشخص میکند. در صورت عدم تعیین سطح دسترسی، مقدار پیشفرض برای این فیلد READER است. |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از User است.
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/postmaster -
https://www.googleapis.com/auth/postmaster.user
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.