WebResource: getToken
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Memerlukan otorisasi
Mendapatkan token verifikasi untuk pengguna terautentikasi untuk ditempatkan di situs atau domain.
Coba sekarang.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/siteVerification/v1/token
Otorisasi
Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut (baca lebih lanjut tentang autentikasi dan otorisasi).
| Cakupan |
|---|
https://www.googleapis.com/auth/siteverification |
https://www.googleapis.com/auth/siteverification.verify_only |
Isi permintaan
Dalam isi permintaan, berikan data dengan struktur berikut:
{
"site": {
"type": string,
"identifier": string
},
"verificationMethod": string
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
site |
object |
Penampung untuk alamat dan jenis situs tempat token verifikasi akan dibuat. |
|
site.type |
string |
Jenis resource yang akan diverifikasi.
Nilai yang dapat diterima:
- "
ANDROID_APP"
- "
INET_DOMAIN"
- "
SITE"
|
|
site.identifier |
string |
ID situs. Jika jenisnya ditetapkan ke SITE, ID-nya adalah URL. Jika jenisnya ditetapkan ke INET_DOMAIN, ID-nya adalah nama domain. |
|
verificationMethod |
string |
Metode verifikasi yang digunakan sistem Verifikasi Situs untuk memverifikasi situs atau domain ini.
Nilai yang dapat diterima:
- "
ANALYTICS": Hanya situs
- "
DNS": Gunakan DNS_TXT sebagai gantinya
- "
DNS_CNAME": Hanya domain
- "
DNS_TXT": Hanya domain
- "
FILE": Hanya situs
- "
META": Hanya situs
- "
TAG_MANAGER": Hanya situs
|
|
Respons
Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:
{
"method": string,
"token": string
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
method |
string |
Metode verifikasi yang Anda pilih dalam permintaan.
Nilai yang dapat diterima:
- "
ANALYTICS"
- "
DNS"
- "
DNS_CNAME"
- "
DNS_TXT"
- "
FILE"
- "
META"
- "
TAG_MANAGER"
|
|
token |
string |
String yang akan ditempatkan di situs pengguna yang diautentikasi, menggunakan metode verifikasi yang dipilih. Untuk informasi selengkapnya, lihat Metode dan token verifikasi dalam dokumen Memulai. |
|
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.
Atau, coba
mandiri
Penjelajah.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[[["\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)."]]
