WebResource
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Eine WebResource ist eine Darstellung einer bestätigten Website oder Domain.
Sie enthält die kanonische ID einer Website oder Domain, die URL oder den Domainnamen und eine Liste der Inhaber. Beachten Sie, dass die Inhaberliste immer den authentifizierten Nutzer enthält, da die einzigen Personen, die auf eine WebResource zugreifen können, authentifizierte Nutzer sind, die Inhaber dieser Website oder Domain sind.
Am Ende dieser Seite finden Sie eine Liste der Methoden für diese Ressource.
Ressourcendarstellungen
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
| Property-Name |
Wert |
Beschreibung |
Hinweise |
id |
string |
Die Zeichenfolge, mit der diese Website identifiziert wird. Dieser Wert sollte im id-Teil der REST-URL für die Vorgänge get, update und delete verwendet werden. |
|
owners[] |
list |
Die E-Mail-Adressen aller direkten, bestätigten Inhaber dieser Property. Indirekte Inhaber, z. B. bestätigte Inhaber der enthaltenden Domain, sind in dieser Liste nicht enthalten. |
|
site |
object |
Container für die Adresse und den Typ einer Website, die bestätigt wird oder noch bestätigt wird. |
|
site.identifier |
string |
Die Website-ID, die je nach Wert der type-Property unterschiedliche Formen hat. |
|
site.type |
string |
Der Websitetyp.
Zulässige Werte sind:
<ph type="x-smartling-placeholder"></ph>
- „
ANDROID_APP“: Lege für identifier eine URL für eine Android-App fest. Example: "android-app://com.google.android.youtube/"
- „
INET_DOMAIN“: Legen Sie für identifier einen Domainnamen fest. Beispiele: „www.beispiel.de“, „beispiel.de“ oder „subdomain.beispiel.de“
- „
SITE“: Geben Sie für identifier eine voll qualifizierte URL für das Stammverzeichnis Ihrer Website an, die mit einem Schrägstrich („/“) endet. Examples: "https://www.example.com/" oder „https://www.beispiel.de/untergeordnete/“
|
|
Methoden
Verwenden Sie die Methode Einfügen, um die Inhaberschaft einer Website oder Domain durch den authentifizierten Nutzer zu bestätigen. Verwenden Sie die Methoden get, update, , delete, um eine Ressource abzurufen oder zu ändern, die bereits für den authentifizierten Nutzer verifiziert wurde.
Mit list können Sie alle verifizierten Ressourcen für den authentifizierten Nutzer aufrufen und mit getToken ein Token auf der Website des authentifizierten Nutzers platzieren.
- Delete
- Stellt die Inhaberschaft einer Website oder Domain fest.
- get
- Ruft die aktuellen Daten für eine Website oder Domain ab.
- getToken
- Ruft ein Bestätigungstoken für den authentifizierten Nutzer ab, das auf einer Website oder in einer Domain platziert werden soll.
- insert
- Verifiziert die Inhaberschaft einer Website oder Domain.
- list
- Ruft die Liste der bestätigten Websites und Domains des authentifizierten Nutzers ab.
- Update
- Damit wird die Liste der Inhaber einer Website oder Domain geändert.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 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."]]
