یک دامنه به حساب کاربر اضافه میکند. اگر دامنهای ارائه نشده باشد، مقدار INVALID_ARGUMENT را برمیگرداند. اگر دامنه قبلاً توسط کاربر ثبت شده باشد، مقدار ALREADY_EXISTS را برمیگرداند.
درخواست HTTP
POST https://gmailpostmastertools.googleapis.com/v2beta/domains
این URL از سینتکس Transcoding در gRPC استفاده میکند.
درخواست بدنه
بدنه درخواست شامل دادههایی با ساختار زیر است:
| نمایش JSON |
|---|
{ "domainId": string } |
| فیلدها | |
|---|---|
domainId | الزامی. دامنهای که باید اضافه شود. مثلاً "example.com" |
بدنه پاسخ
در صورت موفقیت، بدنه پاسخ شامل یک نمونه تازه ایجاد شده از Domain است.
دامنههای مجوز
به یکی از حوزههای OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/postmaster -
https://www.googleapis.com/auth/postmaster.domain
برای اطلاعات بیشتر، به راهنمای مجوز مراجعه کنید.