Method: domains.create

یک دامنه به حساب کاربر اضافه می‌کند. اگر دامنه‌ای ارائه نشده باشد، مقدار INVALID_ARGUMENT را برمی‌گرداند. اگر دامنه قبلاً توسط کاربر ثبت شده باشد، مقدار ALREADY_EXISTS را برمی‌گرداند.

درخواست HTTP

POST https://gmailpostmastertools.googleapis.com/v2beta/domains

این URL از سینتکس Transcoding در gRPC استفاده می‌کند.

درخواست بدنه

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

نمایش JSON 
{
  "domainId": string
}
فیلدها
domainId

string

الزامی. دامنه‌ای که باید اضافه شود. مثلاً "example.com"

بدنه پاسخ

در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از Domain است.

دامنه‌های مجوز

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

  • https://www.googleapis.com/auth/postmaster
  • https://www.googleapis.com/auth/postmaster.domain

برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.