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:
|
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.