Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Herstellen einer Verbindung mit Google Search Console
Die Google Search Console ist eine kostenlose Plattform, die Websitebetreibern zur Verfügung steht, um zu überwachen, wie Google die Website sieht, und um deren organische Präsenz zu optimieren. Dazu gehören die Anzeige von verweisenden Domains, die Leistung der mobilen Website, umfangreiche Suchergebnisse sowie die Suchanfragen und Seiten mit dem höchsten Traffic. Wenn Sie ein Nutzer der Google Search Console sind, können Sie eine Verbindung AWS Glue zu Ihrem Google Search Console-Konto herstellen. Sie können Google Search Console als Datenquelle in Ihren ETL-Aufträgen verwenden. Führen Sie diese Jobs aus, um Daten von der Google Search Console an AWS Dienste oder andere unterstützte Anwendungen zu übertragen.
**Topics**
+ [AWS Glue Unterstützung für die Google Search Console](google-search-console-support.md)
+ [Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten](google-search-console-configuring-iam-permissions.md)
+ [Konfigurieren von Google Search Console](google-search-console-configuring.md)
+ [Konfigurieren von Verbindungen mit Google Search Console](google-search-console-configuring-connections.md)
+ [Lesen aus Google-Search-Console-Entitäten](google-search-console-reading-from-entities.md)
+ [Verbindungsoptionen für Google Search Console](google-search-console-connection-options.md)
+ [Einschränkungen der Google Search Console](google-search-console-limitations.md)
# AWS Glue Unterstützung für die Google Search Console
AWS Glue unterstützt die Google Search Console wie folgt:
**Als Quelle unterstützt?**
Ja. Sie können AWS Glue ETL-Jobs verwenden, um Daten aus der Google Search Console abzufragen.
**Als Ziel unterstützt?**
Nein.
**Unterstützte Versionen der API von Google Search Console**
Die folgenden Versionen der API von Google Search Console werden unterstützt:
+ v3
# Richtlinien, welche die API-Vorgänge für die Erstellung und Verwendung von Verbindungen enthalten
Die folgende Beispielrichtlinie beschreibt die erforderlichen AWS IAM-Berechtigungen für das Erstellen und Verwenden von Verbindungen. Wenn Sie eine neue Rolle erstellen, erstellen Sie eine Richtlinie, die Folgendes enthält:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"glue:ListConnectionTypes",
"glue:DescribeConnectionType",
"glue:RefreshOAuth2Tokens",
"glue:ListEntities",
"glue:DescribeEntity"
],
"Resource": "*"
}
]
}
```
------
Wenn Sie die oben genannte Methode nicht verwenden möchten, verwenden Sie alternativ die folgenden verwalteten IAM-Richtlinien:
+ [AWSGlueServiceRole](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/service-role/AWSGlueServiceRole)— Gewährt Zugriff auf Ressourcen, die verschiedene AWS Glue Prozesse benötigen, um in Ihrem Namen ausgeführt zu werden. Zu diesen Ressourcen gehören AWS Glue Amazon S3, IAM, CloudWatch Logs und Amazon EC2. Wenn Sie die in dieser Richtlinie angegebene Benennungskonvention für Ressourcen einhalten, verfügen AWS Glue Prozesse über die erforderlichen Berechtigungen. Diese Richtlinie wird typischerweise mit Rollen verknüpft, die bei der Definition von Crawlern, Aufträgen und Entwicklungsendpunkten angegeben werden.
+ [AWSGlueConsoleFullAccess](https://console.aws.amazon.com/iam/home#policies/arn:aws:iam::aws:policy/AWSGlueConsoleFullAccess)— Gewährt vollen Zugriff auf AWS Glue Ressourcen, wenn eine Identität, der die Richtlinie zugeordnet ist, die AWS Managementkonsole verwendet. Wenn Sie die Namenskonvention für Ressourcen befolgen, die in dieser Richtlinie angegeben sind, haben Benutzer alle Konsolenfunktionalitäten. Diese Richtlinie wird normalerweise Benutzern der AWS Glue Konsole zugewiesen.
# Konfigurieren von Google Search Console
Bevor Sie Daten aus der Google Search Console übertragen können, müssen Sie die folgenden Anforderungen erfüllen: AWS Glue
## Mindestanforderungen
Die folgenden Anforderungen sind Mindestanforderungen:
+ Sie haben ein Konto bei Google Search Console.
+ Sie haben ein Konto bei Google Cloud Platform und ein Google-Cloud-Projekt.
+ In Ihrem Google-Cloud-Projekt haben Sie die API der Google Search Console aktiviert.
+ In Ihrem Google Cloud-Projekt haben Sie einen OAuth Zustimmungsbildschirm für externe Nutzer konfiguriert. Weitere Informationen finden Sie in der Google Cloud Platform Console-Hilfe unter [Ihren OAuth Einwilligungsbildschirm einrichten](https://support.google.com/cloud/answer/10311615).
+ In Ihrem Google Cloud-Projekt haben Sie eine OAuth 2.0-Client-ID konfiguriert. Informationen [zu den Kundenanmeldedaten, die für den sicheren Zugriff auf Ihre Daten AWS Glue verwendet werden, wenn authentifizierte Anrufe an Ihr Konto getätigt werden, finden Sie unter Einrichtung von OAuth 2.0](https://support.google.com/cloud/answer/6158849).
Wenn Sie diese Anforderungen erfüllen, können Sie eine Verbindung AWS Glue zu Ihrem Google Search Console-Konto herstellen. Für typische Verbindungen müssen Sie in Google Search Console nichts weiter tun.
# Konfigurieren von Verbindungen mit Google Search Console
Die Google Search Console unterstützt den Zuschusstyp AUTHORIZATION\$1CODE für. OAuth2 Die Art der Gewährung bestimmt, wie mit der Google Search Console AWS Glue kommuniziert wird, um Zugriff auf Ihre Daten anzufordern.
+ Diese Art der Gewährung gilt als „dreibeiniges“, OAuth da sie darauf beruht, dass Nutzer zur Authentifizierung des Benutzers an einen Autorisierungsserver eines Drittanbieters weitergeleitet werden. Er wird verwendet, wenn Verbindungen über die Konsole hergestellt werden. AWS Glue
+ Nutzer können sich weiterhin dafür entscheiden, ihre eigene verbundene App in der Google Search Console zu erstellen und ihre eigene Client-ID und ihr eigenes Client-Geheimnis anzugeben, wenn sie Verbindungen über die AWS Glue Konsole herstellen. In diesem Szenario werden sie weiterhin zur Google Search Console weitergeleitet, um sich anzumelden und den Zugriff auf ihre Ressourcen AWS Glue zu autorisieren.
+ Dieser Gewährungstyp führt zu einem Aktualisierungstoken und einem Zugriffstoken. Das Zugriffstoken ist kurzlebig und kann mithilfe des Aktualisierungstokens automatisch ohne Benutzerinteraktion aktualisiert werden.
+ Die öffentliche Dokumentation der Google Search Console zum Erstellen einer verbundenen App für den OAuth Autorisierungscodefluss finden Sie unter [Verwenden von OAuth 2.0 für den Zugriff auf Google APIs](https://developers.google.com/identity/protocols/oauth2).
Konfigurieren einer Verbindung mit Google Search Console:
1. Erstellen Sie in AWS Secrets Manager ein Secret mit den folgenden Details:
1. Für die kundenseitig verwaltete verbundene App muss das Geheimnis das Verbrauchergeheimnis der verbundenen App mit `USER_MANAGED_CLIENT_APPLICATION_CLIENT_SECRET` als Schlüssel enthalten.
1. Hinweis: Sie müssen ein Geheimnis für Ihre Verbindungen in erstellen AWS Glue.
1. Erstellen Sie in AWS Glue Glue Studio eine Verbindung unter **Datenverbindungen**, indem Sie die folgenden Schritte ausführen:
1. Wählen Sie als **Verbindungstyp** Google Search Console aus.
1. Wählen Sie die AWS IAM-Rolle aus, die die folgenden Aktionen übernehmen AWS Glue kann und über Berechtigungen verfügt:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"secretsmanager:DescribeSecret",
"secretsmanager:GetSecretValue",
"secretsmanager:PutSecretValue",
"ec2:CreateNetworkInterface",
"ec2:DescribeNetworkInterfaces",
"ec2:DeleteNetworkInterface"
],
"Resource": "*"
}
]
}
```
------
1. Wählen Sie `secretName` die aus, in die Sie für diese Verbindung die Token einfügen AWS Glue möchten.
1. Wählen Sie die Netzwerkoptionen aus, wenn Sie Ihr Netzwerk verwenden möchten.
1. Erteilen Sie der mit Ihrem AWS Glue Job verknüpften IAM-Rolle `secretName` Leserechte.
# Lesen aus Google-Search-Console-Entitäten
**Voraussetzung**
Ein Google-Search-Console-Objekt, aus dem gelesen werden soll. Sie benötigen den Objektnamen.
**Unterstützte Entitäten für Quelle**:
| Entität | Kann gefiltert werden | Unterstützt Limit | Unterstützt „Sortieren nach“ | Unterstützt „\$1 auswählen“ | Unterstützt Partitionierung |
| --- | --- | --- | --- | --- | --- |
| Suchanalysen | Ja | Ja | Nein | Ja | Nein |
| Sites | Nein | Nein | Nein | Ja | Nein |
| Sitemaps | Nein | Nein | Nein | Ja | Nein |
**Beispiel:**
```
googleSearchConsole_read = glueContext.create_dynamic_frame.from_options(
connection_type="googlesearchconsole",
connection_options={
"connectionName": "connectionName",
"ENTITY_NAME": "entityName",
"API_VERSION": "v3"
}
```
**Google-Search-Console-Entitäts- und Felddetails**:
Google Search Console bietet Endpunkte zum dynamischen Abrufen von Metadaten für unterstützte Entitäten. Dementsprechend wird die Bedienerunterstützung auf der Datentypebene erfasst.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/google-search-console-reading-from-entities.html)
**Anmerkung**
Eine aktualisierte Liste gültiger Werte für Filter finden Sie der Dokumentation zur [Google Search Console](https://developers.google.com/webmaster-tools/v1/searchanalytics/query) API.
Das Feld `start_end_date` ist eine Kombination aus `start_date` und `end_date`.
## Partitionierung von Abfragen
Filterbasierte Partitionierung und datensatzbasierte Partitionierung werden nicht unterstützt.
# Verbindungsoptionen für Google Search Console
Im Folgenden sind Verbindungsoptionen für Google Search Console aufgeführt:
+ `ENTITY_NAME` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Der Name Ihres Objekts in Google Search Console.
+ `API_VERSION` (Zeichenfolge) – (Erforderlich) Zum Lesen verwendet. Version der REST-API von Google Search Console, die Sie verwenden möchten.
+ `SELECTED_FIELDS` (Liste) – Standard: leer(SELECT \$1). Zum Lesen verwendet. Spalten, die Sie für das Objekt auswählen möchten.
+ `FILTER_PREDICATE`(Zeichenfolge) – Standard: "start\$1end\$1date between <30 days ago from current date> AND ". Zum Lesen verwendet. Muss das Spark-SQL-Format aufweisen.
+ `QUERY`(Zeichenfolge) – Standard: "start\$1end\$1date between <30 days ago from current date> AND " Zum Lesen verwendet. Vollständige Spark-SQL-Abfrage.
+ `INSTANCE_URL`(Zeichenfolge) – Zum Lesen verwendet. Eine gültige Instance-URL für Google Search Console.
# Einschränkungen der Google Search Console
Im Folgenden finden Sie Einschränkungen oder Hinweise für Google Search Console:
+ Google Search Console erzwingt Nutzungsbeschränkungen für die API. Weitere Informationen finden Sie unter [Nutzungslimits](https://developers.google.com/webmaster-tools/limits).
+ Wenn kein Filter für die `Search Analytics`-Entität übergeben wurde, summiert die API alle Klicks, Impressionen, Klickraten (CTR) und andere Daten für Ihre gesamte Website innerhalb des angegebenen Standarddatumsbereichs und präsentiert sie als einen einzigen Datensatz.
+ Um die Daten in kleinere Segmente aufzuteilen, müssen Sie der Abfrage Dimensionen hinzufügen. Mit Dimensionen wird der API mitgeteilt, wie Sie Ihre Daten segmentieren möchten.
+ Wenn Sie beispielsweise `filterPredicate: dimensions="country"` hinzufügen, erhalten Sie einen Datensatz für jedes Land, in dem Ihre Website im angegebenen Zeitraum Traffic erhalten hat.
+ Beispiel für die Übergabe mehrerer Dimensionen: `filterPredicate: dimensions="country" AND dimensions="device" AND dimensions="page"`. In diesem Fall erhalten Sie für jede eindeutige Kombination dieser drei Dimensionen eine Zeile in der Antwort.
+ Für die Felder `start_end_date` und `dataState` sind Standardwerte festgelegt.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/glue/latest/dg/google-search-console-limitations.html)