In diesem Leitfaden wird erläutert, wie Sie mit der Ressource EmailPreferences
Ihre Merchant Center-E-Mail-Benachrichtigungen verwalten und sehen, welche Arten von E-Mails Ihr Konto users
erhält. Eine vollständige Liste der E-Mail-Benachrichtigungstypen findest du in der Referenz zu EmailPreferences
.
Sie können die Merchant API nur zum Verwalten von E-Mail-Benachrichtigungen für Konten verwenden, denen Sie als Nutzer hinzugefügt wurden.
Wenn Sie E-Mail-Benachrichtigungen ansehen oder aktualisieren möchten, 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, zu dem du E-Mails zu diesem Konto erhalten oder nicht mehr erhalten möchtest. Wenn das Händlerkonto ein erweitertes Konto ist und der Nutzer Zugriff auf das erweiterte Konto hat, verwende die Händler-ID des erweiterten Kontos.
Benachrichtigungen aktivieren oder deaktivieren
Wenn du die Einstellungen für E-Mail-Benachrichtigungen für ein bestimmtes Händlerkonto aktualisieren möchtest, rufe 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 eine Beispielanfrage, mit der ein Nutzer E-Mail-Benachrichtigungen für ein bestimmtes Händlerkonto deaktivieren kann:
PATCH https://merchantapi.googleapis.com/accounts/v1beta/accounts/merchantId/users/emailAddress/emailPreferences
{
"newsAndTips": "OPTED_OUT"
}
Vorhandene Benachrichtigungen ansehen
Rufen Sie accounts.v1beta.accounts.users.getEmailPreferences
auf, um die aktuellen Einstellungen für E-Mail-Benachrichtigungen für einen bestimmten Nutzer zu sehen.
Hier ist eine Beispielanfrage, bei der merchantId
die Händler-ID des Kontos ist, auf das sich die E-Mail-Benachrichtigungen beziehen, 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 nach einem erfolgreichen Aufruf:
{
"name": "accounts/merchantId/users/emailAddress/emailPreferences",
"newsAndTips": "OPTED_IN"
}
Weitere Informationen zu E-Mail-Benachrichtigungen findest du unter E-Mail-Einstellungen für das Merchant Center ändern.