Questo documento descrive come utilizzare l'API Google Site Verification.
Richiamare l'API
Formato della richiesta
La maggior parte delle operazioni di verifica del sito supportate mappa direttamente i verbi HTTP REST (GET
, POST
, PUT
, DELETE
), come descritto nelle operazioni dell'API Google Site Verification.
Il formato specifico per gli URI dell'API Google Site Verification è:
https://www.googleapis.com/siteVerification/v1/webResource/resourceID?parameters
dove resourceID
è l'identificatore di una risorsa web, parameters
è un parametro da applicare alla query. I parametri effettivi utilizzati variano a seconda dell'operazione che stai eseguendo. Inoltre, se utilizzi OAuth 2.0, devi impostare access_token
in questi parametri.
Le query elenco non richiedono un resourceID, quindi il formato è:
https://www.googleapis.com/siteVerification/v1/webResource?parameters
Puoi effettuare chiamate all'operazione getToken tramite il proprio URI univoco. Il formato di una chiamata a getToken è:
https://www.googleapis.com/siteVerification/v1/token?parameters
Formato dei dati
L'API Google Site Verification restituisce i dati in formato JSON.
JSON (JavaScript Object Notation) è un formato comune dei dati indipendente dal linguaggio che fornisce una semplice rappresentazione testuale di strutture arbitrarie di dati. Per saperne di più, consulta json.org.
Riepilogo operazioni
Nell'API Google Site Verification è possibile richiamare sei diversi metodi su raccolte e risorse, come descritto nella tabella seguente. Gli URL delle API sono relativi a https://www.googleapis.com/siteVerification/v1
.
Operazione | Descrizione | URL e sintassi |
---|---|---|
list | Elenca tutte le risorse all'interno della raccolta dell'utente autenticato. |
|
Inserisci | Verifica un sito o un dominio. Se l'operazione ha esito positivo, inserisce una nuova risorsa web nella raccolta dell'utente. Corpo della richiesta: consulta Risorsa web. Parametro di ricerca: |
|
get | Recupera i dati più recenti per una risorsa web specifica. |
|
aggiorna | Modifica l'elenco dei proprietari per una risorsa specifica. Corpo della richiesta: consulta Risorsa web. Note:
|
|
elimina | Rimuove una risorsa dalla raccolta dell'utente (indica che il sito appartiene all'utente).
|
|
getToken | Recupera il token di verifica da inserire nel sito web dell'utente autenticato. Corpo della richiesta:
|
|
Esempio di chiamate API
Questa sezione presuppone che tu (lo sviluppatore) sia anche l'utente autenticato, come nel caso in cui prova l'API con i tuoi dati di test.
Verificare un nuovo sito
Per verificare un sito,
- Richiedi innanzitutto un token di verifica chiamando getToken.
- Posiziona il token sul tuo sito utilizzando il metodo che preferisci.
- Chiedi a Google di verificare che il sito è tuo utilizzando l'operazione insert.
getToken (richiede autorizzazione)
POST https://www.googleapis.com/siteVerification/v1/token?access_token=
oauth2-token
Richiesta:
POST https://www.googleapis.com/siteVerification/v1/token?access_token=oauth2-token
Content-Type: application/json
{
"verificationMethod": "FILE",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
Risposta:
{ "token": "google12cfc68677988bb4.html", "method": "FILE" }
Inserisci (richiede autorizzazione)
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=
oauth2-token
Richiesta:
POST https://www.googleapis.com/siteVerification/v1/webResource?verificationMethod=FILE&access_token=oauth2-token
Content-Type: application/json
{
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
Risposta:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Recuperare informazioni relative alle risorse web verificate
Puoi recuperare l'elenco completo dei siti e dei domini verificati chiamando list. Puoi recuperare informazioni per una singola risorsa web chiamando get.
Elenco (richiede autorizzazione)
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=
oauth2-token
Richiesta:
GET https://www.googleapis.com/siteVerification/v1/webResource?access_token=oauth2-token
Risposta:
{ "items": [ { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site1", "type": "SITE" } }, { "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/site2", "type": "SITE" } } ] }
Recupera (richiede autorizzazione)
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
Richiesta:
GET https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Risposta:
{ "owners": [ "myself@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Modifica informazioni di verifica
Puoi delegare e revocare la proprietà chiamando update. Puoi rimuovere la tua proprietà chiamando elimina.
Aggiornamento (richiede autorizzazione)
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
Richiesta:
PUT https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Content-Type: application/json
{
"owners": [
"myself@example.com",
"another@example.com",
],
"id": "http%3A%2F%2Fwww.example.com%2F",
"site": {
"identifier": "http://www.example.com",
"type": "SITE"
}
}
Risposta:
{ "owners": [ "myself@example.com", "another@example.com", ], "id": "http%3A%2F%2Fwww.example.com%2F", "site": { "identifier": "http://www.example.com/", "type": "SITE" } }
Elimina (richiede autorizzazione)
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=
oauth2-token
Richiesta:
DELETE https://www.googleapis.com/siteVerification/v1/webResource/http%3A%2F%2Fwww.example.com%2F?access_token=oauth2-token
Risposta:
Codice di stato HTTP 204 (Nessun contenuto), che indica l'esito positivo.