WebResource: getToken
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
نیاز به مجوز دارد
یک رمز تأیید را برای کاربر تأیید شده دریافت می کند تا در یک وب سایت یا دامنه قرار دهد. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/siteVerification/v1/token
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| دامنه |
|---|
https://www.googleapis.com/auth/siteverification |
https://www.googleapis.com/auth/siteverification.verify_only |
درخواست بدن
در بدنه درخواست، داده ها را با ساختار زیر ارائه دهید:
{
"site": {
"type": string,
"identifier": string
},
"verificationMethod": string
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
site | object | محفظه ای برای آدرس و نوع سایتی که برای آن کد تأیید تولید می شود. | |
site. type | string | نوع منبعی که باید تایید شود.
مقادیر قابل قبول عبارتند از:- "
ANDROID_APP " - "
INET_DOMAIN " - "
SITE "
| |
site. identifier | string | شناسه سایت اگر نوع روی SITE تنظیم شده باشد، شناسه یک URL است. اگر نوع روی INET_DOMAIN تنظیم شده باشد، شناسه یک نام دامنه است. | |
verificationMethod | string | روش تأیید برای سیستم تأیید سایت برای تأیید این سایت یا دامنه.
مقادیر قابل قبول عبارتند از:- "
ANALYTICS ": فقط سایت ها - "
DNS ": به جای آن از DNS_TXT استفاده کنید - "
DNS_CNAME ": فقط دامنه ها - "
DNS_TXT ": فقط دامنه ها - "
FILE ": فقط سایت ها - "
META ": فقط سایت ها - "
TAG_MANAGER ": فقط سایت‌ها
| |
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{
"method": string,
"token": string
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
method | string | روش تأییدی که در درخواست انتخاب کردید.
مقادیر قابل قبول عبارتند از:- "
ANALYTICS " - "
DNS " - "
DNS_CNAME " - "
DNS_TXT " - "
FILE " - "
META " - "
TAG_MANAGER "
| |
token | string | رشته ای که با استفاده از روش تأیید انتخاب شده در سایت کاربر تأیید شده قرار می گیرد. برای اطلاعات بیشتر، روش‌ها و نشانه‌های تأیید را در سند شروع کار ببینید. | |
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.
،
نیاز به مجوز دارد
یک رمز تأیید را برای کاربر تأیید شده دریافت می کند تا در یک وب سایت یا دامنه قرار دهد. اکنون آن را امتحان کنید .
درخواست کنید
درخواست HTTP
POST https://www.googleapis.com/siteVerification/v1/token
مجوز
این درخواست به مجوز حداقل با یکی از حوزه های زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
| دامنه |
|---|
https://www.googleapis.com/auth/siteverification |
https://www.googleapis.com/auth/siteverification.verify_only |
درخواست بدن
در بدنه درخواست، داده ها را با ساختار زیر ارائه دهید:
{
"site": {
"type": string,
"identifier": string
},
"verificationMethod": string
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
site | object | محفظه ای برای آدرس و نوع سایتی که برای آن کد تأیید تولید می شود. | |
site. type | string | نوع منبعی که باید تایید شود.
مقادیر قابل قبول عبارتند از:- "
ANDROID_APP " - "
INET_DOMAIN " - "
SITE "
| |
site. identifier | string | شناسه سایت اگر نوع روی SITE تنظیم شده باشد، شناسه یک URL است. اگر نوع روی INET_DOMAIN تنظیم شده باشد، شناسه یک نام دامنه است. | |
verificationMethod | string | روش تأیید برای سیستم تأیید سایت برای تأیید این سایت یا دامنه.
مقادیر قابل قبول عبارتند از:- "
ANALYTICS ": فقط سایت ها - "
DNS ": به جای آن از DNS_TXT استفاده کنید - "
DNS_CNAME ": فقط دامنه ها - "
DNS_TXT ": فقط دامنه ها - "
FILE ": فقط سایت ها - "
META ": فقط سایت ها - "
TAG_MANAGER ": فقط سایت‌ها
| |
پاسخ
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{
"method": string,
"token": string
}| نام ملک | ارزش | توضیحات | یادداشت ها |
|---|
method | string | روش تأییدی که در درخواست انتخاب کردید.
مقادیر قابل قبول عبارتند از:- "
ANALYTICS " - "
DNS " - "
DNS_CNAME " - "
DNS_TXT " - "
FILE " - "
META " - "
TAG_MANAGER "
| |
token | string | رشته ای که با استفاده از روش تأیید انتخاب شده در سایت کاربر تأیید شده قرار می گیرد. برای اطلاعات بیشتر، روش‌ها و نشانه‌های تأیید را در سند شروع کار ببینید. | |
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در داده‌های زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eRetrieves a verification token for website or domain ownership verification upon authorization.\u003c/p\u003e\n"],["\u003cp\u003eSupports various verification methods including \u003ccode\u003eANALYTICS\u003c/code\u003e, \u003ccode\u003eDNS\u003c/code\u003e, \u003ccode\u003eDNS_CNAME\u003c/code\u003e, \u003ccode\u003eDNS_TXT\u003c/code\u003e, \u003ccode\u003eFILE\u003c/code\u003e, \u003ccode\u003eMETA\u003c/code\u003e, and \u003ccode\u003eTAG_MANAGER\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eRequires specifying the site type (\u003ccode\u003eSITE\u003c/code\u003e, \u003ccode\u003eINET_DOMAIN\u003c/code\u003e, or \u003ccode\u003eANDROID_APP\u003c/code\u003e) and identifier (URL or domain name).\u003c/p\u003e\n"],["\u003cp\u003eReturns the selected verification method and the corresponding token to be placed on the site.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization is required with the \u003ccode\u003esiteverification\u003c/code\u003e or \u003ccode\u003esiteverification.verify_only\u003c/code\u003e scope.\u003c/p\u003e\n"]]],["To get a verification token, send a POST request to the specified URL, including authorization with the correct scope. The request body must contain a `site` object with the `type` (e.g., `SITE`, `INET_DOMAIN`) and `identifier` (e.g., URL, domain name) of the site, as well as the desired `verificationMethod`. The successful response will return the chosen `method` and the `token` string to be placed on the site for verification.\n"],null,["# WebResource: getToken\n\n**Requires [authorization](#auth)**\n\nGets a verification token for the authenticated user to place on a website or domain.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPOST https://www.googleapis.com/siteVerification/v1/token\n```\n\n### Authorization\n\nThis request requires authorization with at least one of the following scopes ([read more about authentication and authorization](/site-verification/v1/getting_started#auth)).\n\n| Scope |\n|----------------------------------------------------------------|\n| `https://www.googleapis.com/auth/siteverification` |\n| `https://www.googleapis.com/auth/siteverification.verify_only` |\n\n### Request body\n\nIn the request body, supply data with the following structure:\n\n```carbon\n{\n \"site\": {\n \"type\": string,\n \"identifier\": string\n },\n \"verificationMethod\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|----------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `site` | `object` | Container for the address and type of a site for which a verification token will be generated. | |\n| site.`type` | `string` | The type of resource to be verified. \u003cbr /\u003e Acceptable values are: - \"`ANDROID_APP`\" - \"`INET_DOMAIN`\" - \"`SITE`\" | |\n| site.`identifier` | `string` | The site identifier. If the type is set to `SITE`, the identifier is a URL. If the type is set to `INET_DOMAIN`, the identifier is a domain name. | |\n| `verificationMethod` | `string` | The verification method for the Site Verification system to use to verify this site or domain. \u003cbr /\u003e Acceptable values are: - \"`ANALYTICS`\": Sites only - \"`DNS`\": Use DNS_TXT instead - \"`DNS_CNAME`\": Domains only - \"`DNS_TXT`\": Domains only - \"`FILE`\": Sites only - \"`META`\": Sites only - \"`TAG_MANAGER`\": Sites only | |\n\nResponse\n--------\n\nIf successful, this method returns a response body with the following structure:\n\n```text\n{\n \"method\": string,\n \"token\": string\n}\n```\n\n| Property name | Value | Description | Notes |\n|---------------|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `method` | `string` | The verification method that you selected in the request. \u003cbr /\u003e Acceptable values are: - \"`ANALYTICS`\" - \"`DNS`\" - \"`DNS_CNAME`\" - \"`DNS_TXT`\" - \"`FILE`\" - \"`META`\" - \"`TAG_MANAGER`\" | |\n| `token` | `string` | The string to place on the authenticated user's site, using the selected verification method. For more information, see [Verification methods and tokens](/site-verification/v1/getting_started#tokens) in the Getting Started document. | |\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/siteVerification/v1/siteVerification.webResource.getToken)."]]
