Una risorsa web è una rappresentazione di un sito web o di 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, perché le uniche persone che possono accedere a una risorsa web sono utenti autenticati che sono proprietari del sito o del dominio.
Per un elenco dei metodi disponibili per questa risorsa, vedi la 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 questo sito. Questo valore deve essere utilizzato nella porzione id dell'URL REST per le operazioni get, update e delete. | |
owners[] |
list |
Gli indirizzi email di tutti i proprietari diretti e verificati di questa proprietà esatta. I proprietari indiretti, ad esempio i proprietari verificati del dominio che la contengono, non sono inclusi in questo elenco. | |
site |
object |
Contenitore per l'indirizzo e il tipo di un sito verificati o che lo saranno. | |
site.identifier |
string |
L'identificatore del sito, che prende forme diverse a seconda del valore della proprietà type . |
|
site.type |
string |
Il tipo di sito.
I valori accettati sono:
|
Metodi
Utilizza il metodo insert per verificare la proprietà dell'utente autenticato di un sito web o un dominio. Utilizza i metodi get, update, ed delete per recuperare o modificare una risorsa già verificata per l'utente autenticato.
Puoi visualizzare tutte le risorse verificate per l'utente autenticato utilizzando l'elenco e puoi ottenere un token da inserire nel sito dell'utente autenticato con getToken.
- elimina
- Verifica la proprietà dell'utente di un sito web o di un dominio.
- get
- Recupera i dati più aggiornati per un sito web o un dominio.
- getToken
- Ottieni un token di verifica che l'utente autenticato deve inserire su un sito web o un 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 per un sito web o un dominio.