Method: domains.getVerificationToken

یک توکن تأیید دریافت می‌کند که برای تأیید مالکیت کاربر بر یک دامنه استفاده می‌شود.

درخواست HTTP

GET https://gmailpostmastertools.googleapis.com/v2beta/{name=domains/*/verificationToken}

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

پارامترهای مسیر

پارامترها
name

string

الزامی. نام منبع توکن تأیید برای بازیابی. قالب: domains/{domain}/verificationToken

پارامترهای پرس و جو

پارامترها
verificationMethod

enum ( DomainVerificationMethod )

الزامی. روش تأیید استفاده شده. باید مشخص شود، یعنی TXT یا CNAME.

درخواست بدنه

بدنه درخواست باید خالی باشد.

بدنه پاسخ

توکن DNS که کاربر می‌تواند برای تأیید مالکیت یک دامنه از آن استفاده کند.

در صورت موفقیت، بدنه پاسخ شامل داده‌هایی با ساختار زیر است:

نمایش JSON 
{
  "name": string,
  "token": string,
  "verificationMethod": enum (DomainVerificationMethod)
}
فیلدها
name

string

شناسه. نام منبع توکن تأیید دامنه. قالب: domains/{domain}/verificationToken

token

string

نشانه تأیید.

verificationMethod

enum ( DomainVerificationMethod )

روش تأیید مورد استفاده.

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

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

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

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