Package google.shopping.merchant.notifications.v1beta

Indice

NotificationsApiService

Servizio per la gestione delle iscrizioni alle notifiche per i commercianti

CreateNotificationSubscription

rpc CreateNotificationSubscription(CreateNotificationSubscriptionRequest) returns (NotificationSubscription)

Crea un'iscrizione alle notifiche per un commerciante. Consentiremo contemporaneamente i seguenti tipi di iscrizioni alle notifiche (per commerciante come abbonato e tipo di evento): 1. Abbonamento per tutti gli account gestiti + abbonamento personale 2. Più abbonamenti "parziali" per gli account gestiti + abbonamento autonomo

non consentiamo (per commerciante come abbonato per tipo di evento): 1. più abbonamenti self-service. 2. più abbonamenti "Tutti gli account gestiti". 3. Tutti gli abbonamenti e quelli parziali contemporaneamente. 4. Più abbonamenti parziali per lo stesso account di destinazione

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
DeleteNotificationSubscription

rpc DeleteNotificationSubscription(DeleteNotificationSubscriptionRequest) returns (Empty)

Elimina l'iscrizione alle notifiche per un commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
GetNotificationSubscription

rpc GetNotificationSubscription(GetNotificationSubscriptionRequest) returns (NotificationSubscription)

Riceve le iscrizioni alle notifiche per un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
ListNotificationSubscriptions

rpc ListNotificationSubscriptions(ListNotificationSubscriptionsRequest) returns (ListNotificationSubscriptionsResponse)

Riceve tutte le iscrizioni alle notifiche di un commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.
UpdateNotificationSubscription

rpc UpdateNotificationSubscription(UpdateNotificationSubscriptionRequest) returns (NotificationSubscription)

Consente di aggiornare l'iscrizione alle notifiche esistente di un commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la pagina Panoramica di OAuth 2.0.

Attributo

Enum per specificare l'attributo nella risorsa che viene modificata per informare il commerciante.

Enum
ATTRIBUTE_UNSPECIFIED Attributo non specificato
STATUS Stato dell'entità modificata

CreateNotificationSubscriptionRequest

Messaggio di richiesta per il metodo CreateNotificationSubscription.

Campi
parent

string

obbligatorio. L'account commerciante proprietario della nuova iscrizione alle notifiche. Formato: accounts/{account}
notification_subscription

NotificationSubscription

obbligatorio. L'iscrizione alle notifiche da creare.

DeleteNotificationSubscriptionRequest

Messaggio di richiesta per il metodo DeleteNotificationSubscription.

Campi
name

string

obbligatorio. Il nome dell'iscrizione alle notifiche da eliminare.

GetNotificationSubscriptionRequest

Messaggio di richiesta per il metodo GetNotificationSubscription.

Campi
name

string

obbligatorio. Il name dell'iscrizione alle notifiche.

ListNotificationSubscriptionsRequest

Messaggio di richiesta per il metodo ListNotificationSubscription.

Campi
parent

string

obbligatorio. L'account commerciante proprietario delle iscrizioni alle notifiche. Formato: accounts/{account}
page_size

int32

Il numero massimo di iscrizioni alle notifiche da restituire in una pagina. Il valore predefinito per page_size è 100. Il valore massimo è 200. I valori superiori a 200 verranno forzati a 200.
page_token

string

Token (se fornito) per recuperare la pagina successiva. Tutti gli altri parametri devono corrispondere alla chiamata originale che ha fornito il token di pagina.

ListNotificationSubscriptionsResponse

Messaggio di risposta per il metodo ListNotificationSubscription.

Campi
notification_subscriptions[]

NotificationSubscription

L'elenco di iscrizioni alle notifiche richieste dal commerciante.
next_page_token

string

Un token, che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

NotificationSubscription

Rappresenta un'iscrizione alle notifiche di proprietà di un account commerciante.

Campi
name

string

Solo output. Il name della configurazione delle notifiche. Generati dall'API Content al momento della creazione di un nuovo NotificationSubscription. account rappresenta l'ID commerciante del commerciante proprietario della configurazione. Formato: accounts/{account}/notificationsubscriptions/{notification_subscription}
registered_event

NotificationEventType

L'evento per il quale il commerciante vuole ricevere una notifica.
call_back_uri

string

URL da utilizzare per inviare la notifica al commerciante.

Campo di unione interested_in.

interested_in può essere solo uno dei seguenti:
all_managed_accounts

bool

Se questo valore è true, l'account richiedente riceve una notifica giornaliera dell'evento specificato per tutti gli account gestiti (può trattarsi di account secondari o altri account collegati), inclusi gli account appena aggiunti.
target_account

string

name dell'account per cui vuoi ricevere le notifiche. Formato: accounts/{account}

NotificationEventType

Rappresenta il tipo di evento per il quale il commerciante è interessato a ricevere notifiche.

Enum
NOTIFICATION_EVENT_TYPE_UNSPECIFIED Il tipo di evento di notifica non è specificato.
PRODUCT_STATUS_CHANGE Notifica di variazioni dello stato del prodotto, ad esempio quando il prodotto viene disapprovato.

ProductChange

La modifica apportata al prodotto, inclusi il valore precedente, il nuovo valore, il codice paese come codice regione e il contesto del report.

Campi
old_value

string

Il vecchio valore della risorsa o dell'attributo modificato.
new_value

string

Il nuovo valore della risorsa o dell'attributo modificato.
region_code

string

Paesi interessati dalla modifica (se applicabile)
reporting_context

ReportingContextEnum

Contesti dei report interessati dalla modifica (se applicabile)

ProductStatusChangeMessage

Il messaggio che riceverà il commerciante per la notifica sull'evento di modifica dello stato del prodotto

Campi
changes[]

ProductChange

Un messaggio per descrivere il cambiamento avvenuto al prodotto
account

string

L'account di destinazione proprietario dell'entità che è stata modificata. Formato : accounts/{merchant_id}
managing_account

string

L'account che gestisce l'account del commerciante può essere uguale all'ID commerciante se si tratta di un account autonomo. Formato : accounts/{service_provider_id}
resource_type

Resource

La risorsa modificata, in questo caso sempre Product.
attribute

Attribute

L'attributo nella risorsa che è stato modificato, in questo caso sarà sempre Status.
resource_id

string

L'ID prodotto.
resource

string

Il nome del prodotto. Formato: {product.name=accounts/{account}/products/{product}}

Risorsa

Enum per specificare la risorsa che viene modificata per informare il commerciante.

Enum
RESOURCE_UNSPECIFIED Risorsa non specificata
PRODUCT Tipo di risorsa : prodotto

UpdateNotificationSubscriptionRequest

Messaggio di richiesta per il metodo UpdateNotificationSubscription.

Campi
notification_subscription

NotificationSubscription

obbligatorio. La nuova versione dell'iscrizione alle notifiche che deve essere aggiornata.
update_mask

FieldMask

Elenco dei campi in fase di aggiornamento.