WebResource

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. Die Inhaberliste enthält immer den authentifizierten Nutzer, da nur Nutzer authentifiziert sind, die Inhaber der 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 Der String, mit dem 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 direkt bestätigten Inhaber dieser Property. Indirekte Inhaber, z. B. bestätigte Inhaber der entsprechenden Domain, sind nicht in dieser Liste enthalten.
site object Container für die Adresse und den Typ einer Website, die bestätigt ist oder überprüft wird.
site.identifier string Die Website-ID, die je nach Wert der Property type unterschiedliche Formen annehmen kann.
site.type string Der Websitetyp.

Zulässige Werte:
  • "ANDROID_APP": Setze identifier auf die URL einer Android-App. Beispiel: "android-app://com.google.android.youtube/"
  • "INET_DOMAIN": Setzen Sie identifier auf einen Domainnamen. Beispiele: "www.beispiel.de", "beispiel.de" oder "subdomain.beispiel.de"
  • "SITE": Legen Sie für identifier eine voll qualifizierte URL für das Stammverzeichnis Ihrer Website fest, die mit einem /-Zeichen endet. Beispiele: "https://www.beispiel.de/" oder "https://www.beispiel.de/unterwebsite/"

Methoden

Verwenden Sie die Methode Einfügen, um die Inhaberschaft des authentifizierten Nutzers für eine Website oder Domain zu bestätigen. Verwenden Sie die Methoden get, update und delete, um eine Ressource abzurufen oder zu ändern, die bereits für den authentifizierten Nutzer bestätigt wurde.

Sie können alle bestätigten Ressourcen für den authentifizierten Nutzer mit list aufrufen und mit getToken ein Token auf der Website des authentifizierten Nutzers platzieren.

Delete
Überprüft, ob der Nutzer der Inhaber einer Website oder Domain ist.
Holen Sie sich
Ruft die aktuellsten Daten für eine Website oder Domain ab.
getToken
Ruft ein Bestätigungstoken ab, das der authentifizierte Nutzer auf einer Website oder in einer Domain platzieren kann.
Einfügen
Überprüft die Inhaberschaft einer Website oder Domain.
list
Ruft die Liste der bestätigten Websites und Domains des authentifizierten Nutzers ab.
Aktualisieren
Die Liste der Inhaber einer Website oder Domain ändern.