Questa pagina è stata tradotta dall'API Cloud Translation.

Richiamare l'API

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.	`GET /webResource` Vedi esempio di richiesta list.
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: `verificationMethod`. Il metodo di verifica da utilizzare per questa richiesta. Valori possibili: `FILE`, `META`, `ANALYTICS`, `TAG_MANAGER`, `DNS_TXT`, `DNS_CNAME`	`POST /webResource` Vedi esempio di richiesta di inserimento.
get	Recupera i dati più recenti per una risorsa web specifica.	`GET /webResource/resourceID` Vedi richiesta get di esempio
aggiorna	Modifica l'elenco dei proprietari per una risorsa specifica. Corpo della richiesta: consulta Risorsa web. Note: Non puoi rimuovere l'utente autenticato dall'elenco dei proprietari utilizzando aggiorna. Utilizza elimina. Puoi rimuovere dall'elenco dei proprietari qualsiasi utente che non dispone di un token di verifica sul sito.	`PUT /webResource/resourceID` Vedi esempio di richiesta di aggiornamento.
elimina	Rimuove una risorsa dalla raccolta dell'utente (indica che il sito appartiene all'utente). Note: Prima di chiamare delete, devi rimuovere tutti i token di verifica dell'utente autenticato dal sito o dal dominio. Se sono ancora presenti token, viene restituito un errore HTTP 400 (Richiesta non valida). L'eliminazione influisce solo sui dati di proprietà per l'utente autenticato. Tutti gli altri utenti, che siano stati delegati o verificati in modo indipendente, mantengono la proprietà dopo l'eliminazione.	`DELETE /webResource/resourceID` Vedi esempio di richiesta di eliminazione.
getToken	Recupera il token di verifica da inserire nel sito web dell'utente autenticato. Corpo della richiesta: `identifier`: l'URL del sito o il nome di dominio. `type`: il tipo di risorsa da verificare. Valori possibili: `SITE`, `INET_DOMAIN`. `verificationMethod`: il metodo da utilizzare per la verifica del tuo sito. Valori possibili: `FILE`, `META`, `ANALYTICS`, `TAG_MANAGER`, `DNS_TXT`, `DNS_CNAME`	`POST /token` Vedi esempio di richiesta getToken.

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.