Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Connessione a Google Search Console
Google Search Console è una piattaforma gratuita a disposizione dei proprietari di siti web per monitorare il modo in cui Google visualizza il sito e per ottimizzarne la presenza organica. Questo include la visualizzazione dei domini di riferimento, le prestazioni dei siti per dispositivi mobili, i risultati di ricerca completi e le query e le pagine con il traffico più elevato. Se sei un utente di Google Search Console, puoi connetterti AWS Glue al tuo account Google Search Console. È possibile utilizzare Google Search Console come origine dati nei processi ETL. Esegui questi processi per trasferire dati da Google Search Console ai AWS servizi o ad altre applicazioni supportate.
**Topics**
+ [AWS Glue supporto per Google Search Console](google-search-console-support.md)
+ [Policy contenenti le operazioni API per creare e utilizzare le connessioni](google-search-console-configuring-iam-permissions.md)
+ [Configurazione di Google Search Console](google-search-console-configuring.md)
+ [Configurazione delle connessioni a Google Search Console](google-search-console-configuring-connections.md)
+ [Lettura da entità di Google Search Console](google-search-console-reading-from-entities.md)
+ [Opzioni di connessione di Google Search Console](google-search-console-connection-options.md)
+ [Limitazioni di Google Search Console](google-search-console-limitations.md)
# AWS Glue supporto per Google Search Console
AWS Glue supporta Google Search Console come segue:
**Supportato come origine?**
Sì. Puoi utilizzare i lavori AWS Glue ETL per interrogare i dati da Google Search Console.
**Supportato come destinazione?**
No.
**Versioni supportate dell'API Google Search Console**
Le versioni dell'API Google Search Console supportate sono le seguenti:
+ v3
# Policy contenenti le operazioni API per creare e utilizzare le connessioni
La seguente policy di esempio descrive le autorizzazioni AWS IAM richieste per la creazione e l'utilizzo delle connessioni. Se si sta creando un nuovo ruolo, creare una policy che contenga quanto segue:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
In alternativa, se non desideri utilizzare il metodo precedente, utilizza le seguenti policy IAM gestite:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Garantisce l'accesso alle risorse che AWS Glue i vari processi richiedono per l'esecuzione per conto dell'utente. Queste risorse includono AWS Glue Amazon S3, IAM, CloudWatch Logs e Amazon. EC2 Se segui la convenzione di denominazione delle risorse specificata in questa politica, AWS Glue i processi dispongono delle autorizzazioni richieste. Questa policy è in genere collegata ai ruoli specificati quando si definiscono crawler, processi ed endpoint di sviluppo.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Concede l'accesso completo alle AWS Glue risorse quando un'identità a cui è allegata la policy utilizza la AWS console di gestione. Se si segue la convenzione per la denominazione per le risorse specificate nella policy, gli utenti hanno la piena funzionalità della console. Questa policy è in genere associata agli utenti della AWS Glue console.
# Configurazione di Google Search Console
Prima di poter AWS Glue utilizzare il trasferimento di dati da Google Search Console, devi soddisfare questi requisiti:
## Requisiti minimi
I requisiti minimi sono i seguenti:
+ Hai un account Google Search Console.
+ Hai un account Google Cloud Platform e un progetto Google Cloud.
+ Nel tuo progetto Google Cloud, hai abilitato l'API di Google Search Console.
+ Nel tuo progetto Google Cloud, hai configurato una schermata di OAuth consenso per gli utenti esterni. Per ulteriori informazioni, consulta [Configurazione della schermata di OAuth consenso](https://support.google.com/cloud/answer/10311615) nella guida della console di Google Cloud Platform.
+ Nel tuo progetto Google Cloud, hai configurato un ID client OAuth 2.0. Vedi [Configurazione OAuth 2.0](https://support.google.com/cloud/answer/6158849) per le credenziali del client che AWS Glue utilizza per accedere ai tuoi dati in modo sicuro quando effettua chiamate autenticate al tuo account.
Se soddisfi questi requisiti, sei pronto per connetterti AWS Glue al tuo account Google Search Console. Per le connessioni tipiche, non è necessario fare nient'altro in Google Search Console.
# Configurazione delle connessioni a Google Search Console
Google Search Console supporta il tipo di concessione AUTHORIZATION\$1CODE per. OAuth2 Il tipo di concessione determina il modo in cui AWS Glue comunica con Google Search Console per richiedere l'accesso ai tuoi dati.
+ Questo tipo di concessione è considerato «a tre gambe» in OAuth quanto si basa sul reindirizzamento degli utenti a un server di autorizzazione di terze parti per autenticare l'utente. Viene utilizzato durante la creazione di connessioni tramite la console. AWS Glue
+ Gli utenti possono comunque scegliere di creare la propria app connessa in Google Search Console e fornire il proprio ID cliente e il segreto del client durante la creazione di connessioni tramite la AWS Glue console. In questo scenario, verranno comunque reindirizzati a Google Search Console per accedere e autorizzare l'accesso AWS Glue alle proprie risorse.
+ Questo tipo di concessione genera un token di aggiornamento e un token di accesso. Il token di accesso dura poco tempo e può essere aggiornato automaticamente senza l'interazione dell'utente utilizzando il token di aggiornamento.
+ Per la documentazione pubblica di Google Search Console sulla creazione di un'app connessa per il OAuth flusso del codice di autorizzazione, vedi [Utilizzo della OAuth versione 2.0 per accedere a](https://developers.google.com/identity/protocols/oauth2) Google. APIs
Per configurare una connessione a Google Search Console:
1. In AWS Secrets Manager, crea un segreto con i seguenti dettagli:
1. Per le app connesse gestite dal cliente: il segreto deve contenere l'app connessa Consumer Secret con `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` come chiave.
1. Nota: devi creare un segreto per le tue connessioni in AWS Glue.
1. In AWS Glue Glue Studio, crea una connessione in **Connessioni dati** seguendo i passaggi seguenti:
1. Quando selezioni un **tipo di connessione**, seleziona Google Search Console.
1. Seleziona il ruolo AWS IAM che AWS Glue può assumere e dispone delle autorizzazioni per le seguenti azioni:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Seleziona quello `secretName` che desideri utilizzare per questa connessione per AWS Glue inserire i token.
1. Selezionare le opzioni di rete se si desidera utilizzare la propria rete.
1. Concedi il permesso di lettura `secretName` al ruolo IAM associato al tuo AWS Glue lavoro.
# Lettura da entità di Google Search Console
**Prerequisito**
Un oggetto di Google Search Console da cui si desidera leggere. È necessario il nome dell'oggetto.
**Entità supportate come origine**:
| Entità | Può essere filtrato | Supporta limite | Supporta Ordina per | Supporta Seleziona \$1 | Supporta il partizionamento |
| --- | --- | --- | --- | --- | --- |
| Analisi della ricerca | Sì | Sì | No | Sì | No |
| Siti | No | No | No | Sì | No |
| Mappa del sito | No | No | No | Sì | No |
**Esempio**:
```
googleSearchConsole_read = glueContext.create_dynamic_frame.from_options(
connection_type="googlesearchconsole",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "entityName",
"API_VERSION": "v3"
}
```
**Dettagli dell'entità e dei campi di Google Search Console**:
Google Search Console fornisce endpoint per recuperare i metadati in modo dinamico per le entità supportate. Di conseguenza, il supporto dell'operatore viene acquisito a livello di tipo di dati.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/google-search-console-reading-from-entities.html)
**Nota**
Per un elenco aggiornato dei valori validi per i filtri, consulta i documenti dell'API di [Google Search Console](https://developers.google.com/webmaster-tools/v1/searchanalytics/query).
Il campo `start_end_date` è una combinazione di `start_date` e `end_date`.
## Query di partizionamento
Il partizionamento basato su filtri e il partizionamento basato su record non sono supportati.
# Opzioni di connessione di Google Search Console
Le seguenti sono le opzioni di connessione per Google Search Console:
+ `ENTITY_NAME`(String): (obbligatorio) utilizzato per la lettura. Il nome del tuo oggetto in Google Search Console.
+ `API_VERSION`(String): (obbligatorio) utilizzato per la lettura. La versione dell'API Rest di Google Search Console che desideri utilizzare.
+ `SELECTED_FIELDS`(List): predefinito: vuoto (SELECT \$1). Utilizzato per la lettura. Colonne da selezionare per l'oggetto.
+ `FILTER_PREDICATE`(Stringa): predefinito: “start\$1end\$1date between <30 days ago from current date> AND ". Utilizzato per la lettura. Deve essere in formato Spark SQL.
+ `QUERY`(Stringa): predefinito: “start\$1end\$1date between <30 days ago from current date> AND " utilizzato per la lettura. Query Spark SQL completa.
+ `INSTANCE_URL`(Stringa): utilizzato per la lettura. Un URL di istanza di Google Search Console valido.
# Limitazioni di Google Search Console
Di seguito sono riportate le limitazioni o le note Google Search Console:
+ Google Search Console impone limiti di utilizzo all'API. Per ulteriori informazioni, consulta [Limiti d'uso](https://developers.google.com/webmaster-tools/limits).
+ Quando non viene passato alcun filtro per l'entità `Search Analytics`, l'API riassume tutti i clic, le impressioni, il CTR e gli altri dati dell'intero sito entro l'intervallo di date predefinito specificato e li presenta come un singolo record.
+ Per suddividere i dati in segmenti più piccoli, è necessario introdurre delle dimensioni nella query. Le dimensioni indicano all'API come vuoi segmentare i tuoi dati.
+ Ad esempio, se aggiungi `filterPredicate: dimensions="country"`, otterrai un record per ogni paese in cui il tuo sito ha ricevuto traffico durante il periodo specificato.
+ Esempio per passare a più dimensioni: `filterPredicate: dimensions="country" AND dimensions="device" AND dimensions="page"`. In questo caso otterrai una riga nella risposta per ogni combinazione unica di queste tre dimensioni.
+ I valori predefiniti sono impostati per i campi `start_end_date` e `dataState`.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/glue/latest/dg/google-search-console-limitations.html)