WebResource

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:
  • "ANDROID_APP": imposta identifier su un URL di app Android. Esempio: "android-app://com.google.android.youtube/"
  • "INET_DOMAIN": imposta identifier su un nome di dominio. Esempi: &www;example.com", "example.com" o "subdomain.example.com"
  • "SITE": imposta identifier su un URL completo della root del sito, che termina con il segno /. Esempi: "https://www.example.com/" o "https://www.example.com/subsite/"

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.