WebResource
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
WebResource reprezentuje zweryfikowaną witrynę lub domenę.
Zawiera kanoniczny identyfikator witryny lub domeny, URL lub nazwę domeny oraz listę właścicieli. Pamiętaj, że lista właścicieli zawsze zawiera uwierzytelnionego użytkownika, ponieważ dostęp do zasobu internetowego mają wyłącznie użytkownicy uwierzytelnieni będący właścicielami danej witryny lub domeny.
Listę metod dla tego zasobu znajdziesz na końcu tej strony.
Reprezentacje zasobów
{
"id": string,
"site": {
"type": string,
"identifier": string
},
"owners": [
string
]
}
| Nazwa usługi |
Wartość |
Opis |
Uwagi |
id |
string |
Ciąg tekstowy użyty do identyfikacji tej witryny. Tej wartości należy używać w części id adresu URL REST w operacjach get, update i delete. |
|
owners[] |
list |
Adresy e-mail wszystkich bezpośrednich, zweryfikowanych właścicieli tej usługi. Pośredni właściciele, na przykład zweryfikowani właściciele domeny zawierającej, nie są uwzględnieni na tej liście. |
|
site |
object |
Kontener z adresem i typem witryny, która została lub zostanie zweryfikowana. |
|
site.identifier |
string |
Identyfikator witryny, który przybiera różne formy w zależności od wartości właściwości type. |
|
site.type |
string |
Typ witryny.
Akceptowane wartości to:
- „
ANDROID_APP”: ustaw identifier jako adres URL aplikacji na Androida. Example: "android-app://com.google.android.youtube/"
- „
INET_DOMAIN”: ustaw identifier jako nazwę domeny. Przykłady: „www.example.com”, „example.com” lub „subdomena.example.com”
- „
SITE”: ustaw identifier jako pełny adres URL katalogu głównego witryny, kończący się znakiem /. Examples: "https://www.example.com/" lub „https://www.example.com/podwitryna/”
|
|
Metody
Korzystając z metody wstaw, możesz zweryfikować własność witryny lub domeny uwierzytelnionego użytkownika. Aby pobrać lub zmodyfikować zasób, który został już zweryfikowany dla uwierzytelnionego użytkownika, użyj metod get, update, , delete.
Lista zawiera wszystkie zweryfikowane zasoby uwierzytelnionego użytkownika. Za pomocą metody getToken możesz też uzyskać token do umieszczenia w witrynie uwierzytelnionego użytkownika.
- usuń
- Usuwa własność witryny lub domeny przez użytkownika.
- pobierz
- Pobiera najnowsze dane o witrynie lub domenie.
- getToken,
- Pobiera token weryfikacyjny, który uwierzytelnia użytkownika może umieścić w witrynie lub domenie.
- wstaw
- Przeprowadza weryfikację własności witryny lub domeny.
- list
- Pobiera listę zweryfikowanych witryn i domen uwierzytelnionego użytkownika.
- zaktualizuj
- Modyfikuje listę właścicieli witryny lub domeny.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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."]]
