WebResource
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
WebResource adalah representasi dari situs atau domain terverifikasi.
File ini berisi ID kanonis situs atau domain, URL atau nama domain, dan daftar pemilik. Perhatikan bahwa daftar pemilik selalu menyertakan pengguna terautentikasi, karena satu-satunya orang yang dapat mengakses WebResource adalah pengguna terautentikasi yang merupakan pemilik situs atau domain tersebut.
Untuk daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
| Nama properti |
Nilai |
Deskripsi |
Catatan |
id |
string |
String yang digunakan untuk mengidentifikasi situs ini. Nilai ini harus digunakan di bagian id REST URL untuk operasi get, update, dan delete. |
|
owners[] |
list |
Alamat email semua pemilik langsung yang terverifikasi dari properti yang sama persis. Pemilik tidak langsung—misalnya, pemilik terverifikasi dari domain penampung—tidak disertakan dalam daftar ini. |
|
site |
object |
Penampung untuk alamat dan jenis situs yang telah diverifikasi atau akan diverifikasi. |
|
site.identifier |
string |
ID situs, yang memiliki bentuk berbeda bergantung pada nilai properti type. |
|
site.type |
string |
Jenis situs.
Nilai yang dapat diterima:
- "
ANDROID_APP": Tetapkan identifier ke URL aplikasi Android. Example: "android-app://com.google.android.youtube/"
- "
INET_DOMAIN": Tetapkan identifier ke nama domain. Contoh: "www.example.com", "example.com" atau "subdomain.example.com"
- "
SITE": Tetapkan identifier ke URL yang sepenuhnya memenuhi syarat untuk root situs Anda, yang diakhiri dengan tanda /. Examples: "https://www.example.com/" atau "https://www.example.com/subsite/"
|
|
Metode
Gunakan metode insert untuk memverifikasi kepemilikan situs atau domain milik pengguna yang diautentikasi. Gunakan metode get, update, dan delete untuk mengambil atau mengubah resource yang telah diverifikasi untuk pengguna yang diautentikasi.
Anda dapat melihat semua resource terverifikasi untuk pengguna yang diautentikasi dengan list, dan Anda bisa mendapatkan token untuk ditempatkan di situs pengguna yang diautentikasi dengan getToken.
- hapus
- Memverifikasi kepemilikan situs atau domain pengguna.
- dapatkan
- Mengambil data terbaru untuk situs atau domain.
- getToken
- Mendapatkan token verifikasi untuk pengguna terautentikasi untuk ditempatkan di situs atau domain.
- sisipkan
- Memverifikasi kepemilikan situs atau domain.
- list
- Mendapatkan daftar situs dan domain terverifikasi milik pengguna yang diautentikasi.
- info terbaru
- Memodifikasi daftar pemilik untuk situs atau domain.
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\u003eA WebResource represents a verified website or domain and includes its ID, URL/domain, and a list of owners, which always includes the authenticated user.\u003c/p\u003e\n"],["\u003cp\u003eYou can verify ownership, retrieve, update, and delete WebResources using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eWebResource data includes an ID, owner list, and site information containing the identifier and type (e.g., website, Android app, domain).\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003esite.identifier\u003c/code\u003e can be a domain name, a URL, or an Android app URL depending on the \u003ccode\u003esite.type\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSeveral methods are available to manage WebResources, including inserting (verifying ownership), retrieving data, updating owner lists, deleting, listing all verified resources, and getting a verification token.\u003c/p\u003e\n"]]],["A WebResource represents a verified website or domain, identified by an `id`, `site` (type and identifier), and a list of `owners`, which always includes the authenticated user. Key actions include using `insert` to verify ownership, `get`, `update`, and `delete` to manage existing resources, `list` to view verified sites, and `getToken` to obtain a verification token. Site `type` can be `ANDROID_APP`, `INET_DOMAIN`, or `SITE`, with corresponding identifier formats.\n"],null,["# WebResource\n\n\u003cbr /\u003e\n\nA WebResource is a representation of a verified website or domain.\n\n\u003cbr /\u003e\n\nIt contains the canonical ID of a site or domain, the URL or domain name, and a list of owners. Note that the owners list always includes the authenticated user, because the only people who can access a WebResource are authenticated users who are owners of that site or domain.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nFor a list of [methods](#methods) for this resource, see the end of this page.\n\nResource representations\n------------------------\n\n\u003cbr /\u003e\n\n```carbon\n{\n \"id\": string,\n \"site\": {\n \"type\": string,\n \"identifier\": string\n },\n \"owners\": [\n string\n ]\n}\n```\n\n| Property name | Value | Description | Notes |\n|-------------------|----------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-------|\n| `id` | `string` | The string used to identify this site. This value should be used in the \u003cvar class=\"apiparam\" translate=\"no\"\u003eid\u003c/var\u003e portion of the REST URL for the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) operations. | |\n| `owners[]` | `list` | The email addresses of all direct, verified owners of this exact property. Indirect owners---for example verified owners of the containing domain---are not included in this list. | |\n| `site` | `object` | Container for the address and type of a site that is verified or will be verified. | |\n| site.`identifier` | `string` | The site identifier, which takes different forms depending on the value of the `type` property. | |\n| site.`type` | `string` | The site type. \u003cbr /\u003e Acceptable values are: - \"`ANDROID_APP`\": Set `identifier` to an Android app URL. **Example:** \"android-app://com.google.android.youtube/\" - \"`INET_DOMAIN`\": Set `identifier` to a domain name. **Examples:** \"www.example.com\", \"example.com\" or \"subdomain.example.com\" - \"`SITE`\": Set `identifier` to a fully-qualified URL for your site root, ending in a / mark. **Examples:** \"https://www.example.com/\" or \"https://www.example.com/subsite/\" | |\n\nMethods\n-------\n\n\u003cbr /\u003e\n\nUse the [insert](/site-verification/v1/webResource/insert) method to verify the authenticated user's ownership of a website or domain. Use the [get](/site-verification/v1/webResource/get), [update](/site-verification/v1/webResource/update), and [delete](/site-verification/v1/webResource/delete) methods to retrieve or modify a resource that has already been verified for the authenticated user.\n\nYou can see all verified resources for the authenticated user with [list](/site-verification/v1/webResource/list), and you can get a token to place on the authenticated user's site with [getToken](/site-verification/v1/webResource/getToken).\n\n\u003cbr /\u003e\n\n[delete](/site-verification/v1/webResource/delete)\n: Unverifies the user's ownership of a website or domain.\n\n[get](/site-verification/v1/webResource/get)\n: Retrieves the most current data for a website or domain.\n\n[getToken](/site-verification/v1/webResource/getToken)\n: Gets a verification token for the authenticated user to place on a website or domain.\n\n[insert](/site-verification/v1/webResource/insert)\n: Verifies ownership of a website or domain.\n\n[list](/site-verification/v1/webResource/list)\n: Gets the list of the authenticated user's verified websites and domains.\n\n[update](/site-verification/v1/webResource/update)\n: Modifies the list of owners for a website or domain."]]
