In diesem Leitfaden wird erläutert, wie Sie die Merchant Center-E-Mail-Benachrichtigungen über die Ressource EmailPreferences
verwalten und sehen können, welche Arten von E-Mails an die users
Ihres Kontos gesendet werden.
Eine vollständige Liste der E-Mail-Benachrichtigungstypen finden Sie in der EmailPreferences
-Referenz.
Sie können die Merchant API nur für Konten verwenden, in denen Sie als Nutzer hinzugefügt wurden.
Um E-Mail-Benachrichtigungen aufzurufen oder zu aktualisieren, benötigen Sie die folgenden Werte:
- Die E-Mail-Adresse des Nutzers, der die E-Mails erhält. Die E-Mail-Adresse finden Sie im Feld
name
der RessourceUser
. - Die Händler-ID des Kontos, für das Sie E-Mails erhalten möchten oder nicht mehr erhalten möchten. Wenn es sich bei dem Händlerkonto um ein erweitertes Konto handelt und der Nutzer Zugriff auf das erweiterte Konto hat, verwenden Sie die Händler-ID des erweiterten Kontos.
Benachrichtigungen aktivieren oder deaktivieren
Wenn Sie die Einstellungen für E-Mail-Benachrichtigungen für ein bestimmtes Händlerkonto aktualisieren möchten, rufen Sie accounts.v1beta.accounts.users.updateEmailPreference
mit der merchantId
des Kontos und der E-Mail-Adresse des Nutzers auf.
Mit den folgenden Werten können Sie festlegen, welche E-Mail-Benachrichtigungen der Nutzer erhält:
OPTED_IN
: E-Mail-Benachrichtigungen für das Konto erhalten.OPTED_OUT
: Sie erhalten keine E-Mail-Benachrichtigungen für das Konto.
Hier ist ein Beispiel für eine Anfrage, um E-Mail-Benachrichtigungen für ein bestimmtes Händlerkonto zu deaktivieren:
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
{
"newsAndTips": "OPTED_OUT"
}
Vorhandene Benachrichtigungen ansehen
Wenn Sie die aktuellen E-Mail-Benachrichtigungseinstellungen für einen bestimmten Nutzer aufrufen möchten, geben Sie accounts.v1beta.accounts.users.getEmailPreferences
ein.
Hier ist eine Beispielanfrage, in der merchantId
die Händler-ID des Kontos ist, für das die E-Mail-Benachrichtigungen gelten, und emailAddress
die E-Mail-Adresse des Nutzers, der die E-Mails erhält.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
Hier ist eine Beispielantwort für einen erfolgreichen Aufruf:
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
Weitere Informationen zu E-Mail-Benachrichtigungen finden Sie unter E-Mail-Einstellungen für das Merchant Center ändern.