WebResource
Mantieni tutto organizzato con le raccolte
Salva e classifica i contenuti in base alle tue preferenze.
Una risorsa web è una rappresentazione di un sito web o un dominio verificato.
Contiene l'ID canonico di un sito o un dominio, l'URL o il nome di dominio e un elenco di proprietari. Tieni presente che l'elenco dei proprietari include sempre l'utente autenticato, poiché le uniche persone che possono accedere a una risorsa WebResource sono gli utenti autenticati proprietari di quel sito o dominio.
Per un elenco di metodi per questa risorsa, vai alla fine di questa pagina.
Rappresentazioni delle risorse
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
Nome proprietà |
Valore |
Descrizione |
Note |
id |
string |
La stringa utilizzata per identificare il sito. Questo valore deve essere utilizzato nella porzione id dell'URL REST per le operazioni get, update ed delete. |
|
owners[] |
list |
Gli indirizzi email di tutti i proprietari diretti e verificati di questa esatta proprietà. I proprietari indiretti, ad esempio i proprietari verificati del dominio contenitore, non sono inclusi in questo elenco. |
|
site |
object |
Contenitore per l'indirizzo e il tipo di sito che è stato verificato o che verrà verificato. |
|
site.identifier |
string |
L'identificatore del sito, che assume forme diverse a seconda del valore della proprietà type . |
|
site.type |
string |
Il tipo di sito.
I valori accettati sono:
- "
ANDROID_APP ": imposta identifier sull'URL di un'app per Android. Example: "android-app://com.google.android.youtube/"
- "
INET_DOMAIN ": imposta identifier su un nome di dominio. Esempi: "www.example.com", "example.com" o "subdomain.example.com"
- "
SITE ": imposta identifier su un URL completo per la directory radice del tuo sito, che termina con il segno /. Examples: "https://www.example.com/" o "https://www.example.com/subsite/"
|
|
Metodi
Utilizza il metodo insert per verificare la proprietà di un sito web o di un dominio da parte dell'utente autenticato. Utilizza i metodi get, update, e delete per recuperare o modificare una risorsa che è già stata verificata per l'utente autenticato.
Puoi visualizzare tutte le risorse verificate per l'utente autenticato mediante l'elenco e ottenere un token da inserire sul sito dell'utente autenticato con getToken.
- elimina
- Verifica la proprietà di un sito web o di un dominio da parte dell'utente.
- trova
- Recupera i dati più aggiornati per un sito web o un dominio.
- getToken
- Riceve un token di verifica che l'utente autenticato deve inserire su un sito web o dominio.
- inserisci
- Verifica la proprietà di un sito web o di un dominio.
- list
- Recupera l'elenco dei siti web e dei domini verificati dell'utente autenticato.
- aggiorna
- Modifica l'elenco dei proprietari di un sito web o di un dominio.
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2025-07-25 UTC.
[null,null,["Ultimo aggiornamento 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."]]