Package google.shopping.merchant.accounts.v1beta

Indice

AccountIssueService

Servizio per supportare l'API AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Elenca tutti i problemi dell'account di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

AccountsService

Servizio per supportare l'API Accounts.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Crea un account Merchant Center autonomo con una configurazione aggiuntiva. Aggiunge l'utente che effettua la richiesta come amministratore del nuovo account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Consente di eliminare l'account specificato, indipendentemente dal tipo: indipendente, AMC o subaccount. L'eliminazione di un AMC comporta l'eliminazione di tutti i relativi subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo. L'eliminazione va a buon fine solo se l'account non fornisce servizi ad altri account e non ha offerte elaborate. Puoi utilizzare il parametro force per eseguire l'override.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera un account dal tuo account Merchant Center. Dopo aver inserito, aggiornato o eliminato un account, potrebbero essere necessari diversi minuti prima che le modifiche vengano applicate.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Elenca gli account accessibili all'utente che chiama e che corrispondono ai vincoli della richiesta, ad esempio le dimensioni della pagina o i filtri. Non vengono elencati solo i subaccount di un AMC, ma tutti gli account a cui l'utente che chiama ha accesso, inclusi altri AMC, account collegati, account indipendenti e così via. Se non viene fornito alcun filtro, vengono restituiti gli account a cui l'utente è aggiunto direttamente. Questo metodo è eventualmente coerente, il che significa che modifiche come la creazione, l'aggiornamento di un account o la modifica delle relazioni tra gli account potrebbero non essere visualizzate immediatamente nei risultati. Queste modifiche vengono invece propagate in un breve periodo di tempo, dopodiché le informazioni aggiornate possono corrispondere ai predicati associati. Ciò significa che la ricerca per nome dell'account potrebbe non restituire un account modificato di recente anche se soddisfa il predicato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Elenca tutti i subaccount di un determinato account multi-cliente. Si tratta di un wrapper pratico per il metodo ListAccounts più potente. Questo metodo produrrà gli stessi risultati dell'utilizzo di ListsAccounts con il seguente filtro: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Aggiorna un account indipendentemente dal tipo: indipendente, AMC o subaccount. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

AutofeedSettingsService

Servizio per supportare l'impostazione feed automatico.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Recupera le impostazioni del feed automatico di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Aggiorna le impostazioni del feed automatico di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

BusinessIdentityService

Servizio per supportare l'API Business Identity.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Recupera l'identità dell'attività di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Aggiorna l'identità dell'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

BusinessInfoService

Servizio per supportare l'API di informazioni sull'attività.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Recupera le informazioni sull'attività di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Aggiorna le informazioni sull'attività di un account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

EmailPreferencesService

Servizio per supportare l'API EmailPreferences.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Restituisce le preferenze email di un utente dell'account Merchant Center. Questo servizio consente solo di recuperare e aggiornare le preferenze email per l'utente autenticato. Utilizza l'alias name=accounts/*/users/me/emailPreferences per ottenere le preferenze per l'utente autenticato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Aggiorna le preferenze email di un utente dell'account Merchant Center. Gli utenti dell'AMC devono specificare l'account AMC anziché un subaccount dell'AMC.

Le preferenze non selezionate esplicitamente nella maschera di aggiornamento non verranno aggiornate.

Non è valido specificare un valore di stato di attivazione UNCONFIRMED per gli aggiornamenti.

Utilizza l'alias name=accounts/*/users/me/emailPreferences per aggiornare le preferenze per l'utente autenticato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

HomepageService

Servizio per supportare un'API per la home page di un negozio.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Rivendica la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Se la home page è già stata rivendicata, la verifica verrà riesaminata (a meno che il commerciante non sia esente dalla rivendicazione, il che comporta anche l'esenzione dalla verifica) e verrà restituita una risposta positiva. Se la proprietà non può più essere verificata, verrà restituito un errore, ma la rivendicazione non verrà cancellata. In caso di errore, verrà restituito un messaggio di errore canonico: * PERMISSION_DENIED: l'utente non dispone delle autorizzazioni necessarie per questo account MC; * FAILED_PRECONDITION: - L'account non è un account Merchant Center; - L'account MC non ha una home page; - Claiming failed (in this case the error message will contain more details) (Claiming failed (in questo caso il messaggio di errore conterrà ulteriori dettagli)).

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Recupera la home page di un negozio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Annullare la rivendicazione della home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Aggiorna la home page di un negozio. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

OnlineReturnPolicyService

Il servizio semplifica la gestione della configurazione delle norme sui resi per ripensamento del commerciante, che includono le norme sui resi sia per gli annunci sia per le schede senza costi

programmi. Questa API definisce il seguente modello di risorse:

[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Recupera le norme sui resi esistenti per un determinato commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Elenca tutte le norme sui resi esistenti per un determinato commerciante.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

ProgramsService

Servizio per la gestione del programma.

I programmi forniscono un meccanismo per aggiungere funzionalità agli account commerciante. Un esempio tipico è il programma Schede di prodotto senza costi, che consente di mostrare i prodotti del negozio di un commerciante senza costi su Google.

Questo servizio espone metodi per recuperare la partecipazione di un commerciante a tutti i programmi disponibili, oltre a metodi per attivare o disattivare esplicitamente la partecipazione a ciascun programma.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Disattivare la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Attivare la partecipazione al programma specificato per l'account. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Recupera il programma specificato per l'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Recupera tutti i programmi per l'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

RegionsService

Gestisce la configurazione delle regioni.

Questa API definisce il seguente modello di risorse:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Crea una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Consente di eliminare una definizione di regione dal tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Recupera una regione definita nel tuo account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Elenca le regioni nel tuo account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Aggiorna una definizione di regione nel tuo account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

ShippingSettingsService

Servizio per ottenere informazioni sulle impostazioni di spedizione delle chiamate ai metodi per ogni metodo dell'API Merchant.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Recupera le informazioni sulle impostazioni di spedizione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Sostituisci l'impostazione di spedizione di un commerciante con l'impostazione di richiesta di spedizione. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

TermsOfServiceAgreementStateService

Servizio per supportare l'API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Restituisce lo stato di un contratto con Termini di servizio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Recupera lo stato del contratto per i Termini di servizio dell'applicazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

TermsOfServiceService

Servizio per supportare l'API TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Accetta un TermsOfService. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Recupera il TermsOfService associato alla versione fornita.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Recupera la versione più recente del TermsOfService per un determinato kind e region_code.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

UserService

Servizio per supportare l'API utente.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Crea un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Consente di eliminare un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo. L'utente da eliminare non può essere l'ultimo utente amministratore dell'account. Inoltre, un utente è protetto dall'eliminazione se è gestito da Business Manager"

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
GetUser

rpc GetUser(GetUserRequest) returns (User)

Recupera un utente dell'account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Elenca tutti gli utenti di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.
Aggiorna utente

rpc UpdateUser(UpdateUserRequest) returns (User)

Aggiorna un utente dell'account Merchant Center. L'esecuzione di questo metodo richiede l'accesso amministrativo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

AcceptTermsOfServiceRequest

Messaggio di richiesta per il metodo AcceptTermsOfService.

Campi
name

string

Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}
account

string

Obbligatorio. L'account per cui accettare i TdS.
region_code

string

Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese quando i TdS si applicano specificamente a quel paese o di 001 quando si applicano a livello globale.

Accettato

Descrive i Termini di servizio accettati.

Campi
terms_of_service

string

I termsOfService accettati.
accepted_by

string

L'account in cui è stata registrata l'accettazione. Può trattarsi dell'account stesso o, nel caso dei subaccount, dell'account AMC.
valid_until

Date

Se impostato, indica che i TermsOfService accettati sono validi solo fino alla fine di questa data (in UTC). Prima di questa data, dovrai accettarne uno nuovo. Le informazioni relative a TermsOfService obbligatorie sono riportate nel messaggio Obbligatorio.

AccessRight

Il diritto di accesso.

Enum
ACCESS_RIGHT_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
STANDARD Diritti di accesso standard.
ADMIN Diritti di accesso amministrativo.
PERFORMANCE_REPORTING Gli utenti con questo diritto hanno accesso a rendimento e approfondimenti.

Account

Il messaggio Account rappresenta l'account di un commerciante negli annunci Shopping. È l'entità principale per la gestione dei dati di prodotto, delle impostazioni e delle interazioni con i servizi di Google e i fornitori esterni.

Gli account possono operare come entità autonome o far parte di una struttura di account multi-cliente (AMC). In una configurazione AMC, l'account principale gestisce più subaccount.

La creazione di un account prevede la configurazione di attributi come il nome dell'account, il fuso orario e le preferenze relative alla lingua.

Il messaggio Account è l'entità principale di molte altre risorse, ad esempio AccountRelationship, Homepage, BusinessInfo e così via.

Campi
name

string

Identificatore. Il nome della risorsa dell'account. Formato: accounts/{account}
account_id

int64

Solo output. L'ID dell'account.
account_name

string

Obbligatorio. Un nome leggibile dell'account. Per ulteriori informazioni, consulta nome del negozio e nome dell'attività.
adult_content

bool

Indica se l'account include contenuti per adulti.
test_account

bool

Solo output. Indica se si tratta di un account di prova.
time_zone

TimeZone

Obbligatorio. Il fuso orario dell'account.

Durante le scritture, time_zone imposta sia reporting_time_zone che display_time_zone.

Per le letture, time_zone restituisce sempre display_time_zone. Se display_time_zone non esiste per il tuo account, time_zone è vuoto.
language_code

string

Obbligatorio. Il codice lingua BCP-47 dell'account, ad esempio en-US o sr-Latn.

AccountAggregation

Questo tipo non contiene campi.

AccountAggregation payload.

AccountIssue

Un AccountIssue.

Campi
name

string

Identificatore. Il nome della risorsa del problema dell'account. Formato: accounts/{account}/issues/{id}
title

string

Il titolo localizzato del problema.
severity

Severity

La gravità complessiva del problema.
impacted_destinations[]

ImpactedDestination

L'impatto di questo problema sulle varie destinazioni.
detail

string

Ulteriori dettagli localizzati sul problema.
documentation_uri

string

Link al Centro assistenza Merchant Center che fornisce ulteriori informazioni sul problema e su come risolverlo.

ImpactedDestination

L'impatto del problema su una destinazione.

Campi
impacts[]

Impact

L'impatto (negativo) per varie regioni sulla destinazione specificata.
reporting_context

ReportingContextEnum

Il contesto dei report interessato.

Impatto

L'impatto del problema su una regione.

Campi
region_code

string

Il codice regione CLDR a cui si applica il problema.
severity

Severity

La gravità del problema nella destinazione e nella regione.

Gravità

Tutte le possibili gravità dei problemi.

Enum
SEVERITY_UNSPECIFIED La gravità è sconosciuta.
CRITICAL Il problema causa la mancata pubblicazione delle offerte.
ERROR Il problema potrebbe interessare le offerte (in futuro) o essere un indicatore di problemi con le offerte.
SUGGESTION Il problema è un suggerimento per il miglioramento.

Indirizzo

Indirizzo di spedizione del magazzino.

Campi
street_address

string

La parte dell'indirizzo a livello di strada. Ad esempio: 111w 31st Street.
city

string

Obbligatorio. Città, paese o comune. Può includere anche località o sottolocalità dipendenti (ad esempio quartieri o sobborghi).
administrative_area

string

Obbligatorio. Suddivisione amministrativa di primo livello del paese. Ad esempio, uno stato come la California ("CA") o una provincia come il Québec ("QC").
postal_code

string

Obbligatorio. Codice postale (ad es. "94043").
region_code

string

Obbligatorio. Codice paese CLDR (ad es. "US").

AutofeedSettings

Raccolta di informazioni relative alle impostazioni del feed automatico.

Campi
name

string

Identificatore. Il nome della risorsa delle impostazioni del feed automatico. Formato: accounts/{account}/autofeedSettings.
enable_products

bool

Obbligatorio. Attiva o disattiva la scansione dei prodotti tramite il feed automatico per l'account specificato. Gli account feed automatico devono soddisfare determinate condizioni, che possono essere verificate tramite il campo eligible. L'account non deve essere un marketplace. Quando il feed automatico viene attivato per la prima volta, i prodotti vengono visualizzati di solito immediatamente. Quando riattivi la funzionalità, potrebbero essere necessarie fino a 24 ore prima che i prodotti vengano visualizzati.
eligible

bool

Solo output. Determina se il commerciante è idoneo alla registrazione a un feed automatico.

BusinessDayConfig

Giorni lavorativi del magazzino.

Campi
business_days[]

Weekday

Obbligatorio. Giorni lavorativi regolari. Non può essere vuoto.

Giorno feriale

Enum
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Raccolta di informazioni relative all'identità di un'attività.

Campi
name

string

Identificatore. Il nome della risorsa dell'identità dell'attività. Formato: accounts/{account}/businessIdentity
black_owned

IdentityAttribute

Facoltativo. Specifica se l'attività si identifica come di proprietà di persone di colore. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su US. Inoltre, non è applicabile ai marketplace o ai venditori del marketplace.
women_owned

IdentityAttribute

Facoltativo. Specifica se l'attività si identifica come di proprietà di donne. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su US. Inoltre, non è applicabile ai marketplace o ai venditori del marketplace.
veteran_owned

IdentityAttribute

Facoltativo. Specifica se l'attività si identifica come di proprietà di veterani di guerra. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su US. Inoltre, non è applicabile ai marketplace o ai venditori del marketplace.
latino_owned

IdentityAttribute

Facoltativo. Specifica se l'attività si identifica come di proprietà di latinoamericani. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su US. Inoltre, non è applicabile ai marketplace o ai venditori del marketplace.
small_business

IdentityAttribute

Facoltativo. Specifica se l'attività si identifica come piccola impresa. Questo campo facoltativo sarà disponibile solo per i commercianti con un paese dell'attività impostato su US. Inoltre, non è applicabile ai marketplace.

IdentityAttribute

Tutte le informazioni relative a un attributo identità.

Campi
identity_declaration

IdentityDeclaration

Obbligatorio. La dichiarazione di identità per questo attributo.

IdentityDeclaration

Tutte le impostazioni possibili relative alla dichiarazione di un'identità.

Enum
IDENTITY_DECLARATION_UNSPECIFIED Valore predefinito che indica che non è stata effettuata alcuna selezione.
SELF_IDENTIFIES_AS Indica che l'account si identifica con l'attributo.
DOES_NOT_SELF_IDENTIFY_AS Indica che l'account non è identificato dall'attributo.

PromotionsConsent

Tutte le impostazioni possibili relative alle promozioni correlate all'identità dell'attività.

Enum

BusinessInfo

Il messaggio BusinessInfo contiene informazioni essenziali sull'attività di un commerciante.

Questo messaggio acquisisce i dettagli chiave dell'attività, come indirizzo fisico, contatti dell'assistenza clienti e identificatori specifici per regione.

Campi
name

string

Identificatore. Il nome della risorsa delle informazioni sull'attività. Formato: accounts/{account}/businessInfo
address

PostalAddress

Facoltativo. L'indirizzo dell'attività. Sono supportati solo i campi region_code, address_lines, postal_code, administrative_area e locality. Tutti gli altri campi vengono ignorati.
phone

PhoneNumber

Solo output. Il numero di telefono dell'attività.
phone_verification_state

PhoneVerificationState

Solo output. Lo stato della verifica telefonica dell'attività.
customer_service

CustomerService

Facoltativo. L'assistenza clienti dell'attività.
korean_business_registration_number

string

Facoltativo. Il numero di registrazione dell'attività per la Corea del Sud di 10 cifre separato da trattini nel formato: XXX-XX-XXXXX.

CarrierRate

Un elenco di tariffe dell'operatore a cui è possibile fare riferimento tramite main_table o single_value. I servizi di corrieri supportati sono definiti in https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Campi
name

string

Obbligatorio. Nome della tariffa del corriere. Deve essere univoco per ogni gruppo di tariffe.
carrier

string

Obbligatorio. Servizio dell'operatore, ad esempio "UPS" o "Fedex".
carrier_service

string

Obbligatorio. Servizio dell'operatore, ad esempio "ground" o "2 days".
origin_postal_code

string

Obbligatorio. Origine della spedizione per questa tariffa del corriere.
percentage_adjustment

string

Facoltativo. Modificatore della tariffa di spedizione moltiplicativo come numero in notazione decimale. Può essere negativo. Ad esempio, "5.4" aumenta la tariffa del 5,4%, mentre "-3" la diminuisce del 3%.
flat_adjustment

Price

Facoltativo. Modificatore della tariffa di spedizione additiva. Può essere negativo. Ad esempio, { "amount_micros": 1, "currency_code" : "USD" } aggiunge 1 $alla tariffa, mentre { "amount_micros": -3, "currency_code" : "USD" } rimuove 3 $dalla tariffa.

ClaimHomepageRequest

Messaggio di richiesta per il metodo ClaimHomepage.

Campi
name

string

Obbligatorio. Il nome della home page da rivendicare. Formato: accounts/{account}/homepage
overwrite

bool

Facoltativo. Se impostata su true, questa opzione rimuove qualsiasi rivendicazione esistente sul sito web richiesto e la sostituisce con una rivendicazione dell'account che effettua la richiesta.

CreateAndConfigureAccountRequest

Messaggio di richiesta per il metodo CreateAndConfigureAccount.

Campi
account

Account

Obbligatorio. L'account da creare.
users[]
(deprecated)

CreateUserRequest

Facoltativo. Utenti da aggiungere all'account.

Questo campo è deprecato e non esisterà dopo l'uscita dalla versione beta dell'API. Utilizza invece il campo user.
user[]

AddUser

Facoltativo. Utenti da aggiungere all'account.
service[]

AddAccountService

Obbligatorio. Nell'ambito della creazione viene inizializzato un servizio account tra l'account da creare e l'account del provider. È necessario fornire almeno un servizio di questo tipo. Al momento, è necessario che esattamente uno di questi valori sia account_aggregation, il che significa che puoi creare solo subaccount, non account autonomi, tramite questo metodo. Potrebbero essere forniti servizi account_management o product_management aggiuntivi.

AddAccountService

Istruzioni aggiuntive per aggiungere i servizi dell'account durante la creazione dell'account.

Campi
Campo unione service_type. Il tipo di servizio da aggiungere. service_type può essere solo uno dei seguenti:
account_aggregation

AccountAggregation

Il fornitore è un aggregatore per l'account. Payload per il tipo di servizio Aggregazione account.
provider

string

Obbligatorio. Il fornitore del servizio. Il riferimento a un account come providers/123 o a un fornitore di servizi noto (uno di providers/GOOGLE_ADS o providers/GOOGLE_BUSINESS_PROFILE).

AddUser

Istruzioni per aggiungere un utente all'account durante la creazione.

Campi
user_id

string

Obbligatorio. L'indirizzo email dell'utente (ad esempio john.doe@gmail.com).
user

User

Facoltativo. Dettagli sull'utente da aggiungere. Al momento, è possibile specificare solo i diritti di accesso.

CreateRegionRequest

Messaggio di richiesta per il metodo CreateRegion.

Campi
parent

string

Obbligatorio. L'account per cui creare una regione. Formato: accounts/{account}
region_id

string

Obbligatorio. L'identificatore della regione, univoco per tutte le regioni dello stesso account.
region

Region

Obbligatorio. La regione da creare.

CreateUserRequest

Messaggio di richiesta per il metodo CreateUser.

Campi
parent

string

Obbligatorio. Il nome della risorsa dell'account per cui verrà creato un utente. Formato: accounts/{account}
user_id

string

Obbligatorio. L'indirizzo email dell'utente (ad esempio john.doe@gmail.com).
user

User

Facoltativo. L'utente da creare.

CustomerService

Informazioni sull'assistenza clienti.

Campi
uri

string

Facoltativo. L'URI in cui è possibile trovare l'assistenza clienti.
email

string

Facoltativo. L'indirizzo email a cui è possibile contattare l'assistenza clienti.
phone

PhoneNumber

Facoltativo. Il numero di telefono a cui è possibile chiamare l'assistenza clienti.

CutoffTime

Definizione dell'ora limite dei giorni lavorativi.

Campi
hour

int32

Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato nello stesso giorno.
minute

int32

Obbligatorio. Minuto dell'orario limite entro il quale deve essere effettuato un ordine per consentirne l'elaborazione nello stesso giorno.
time_zone

string

Obbligatorio. Identificatore del fuso orario, ad esempio "Europe/Zurich".

DeleteAccountRequest

Messaggio di richiesta per il metodo DeleteAccount.

Campi
name

string

Obbligatorio. Il nome dell'account da eliminare. Formato: accounts/{account}
force

bool

Facoltativo. Se impostato su true, l'account viene eliminato anche se fornisce servizi ad altri account o ha elaborato offerte.

DeleteRegionRequest

Messaggio di richiesta per il metodo DeleteRegion.

Campi
name

string

Obbligatorio. Il nome della regione da eliminare. Formato: accounts/{account}/regions/{region}

DeleteUserRequest

Messaggio di richiesta per il metodo DeleteUser.

Campi
name

string

Obbligatorio. Il nome dell'utente da eliminare. Formato: accounts/{account}/users/{email}

È anche possibile eliminare l'utente corrispondente all'utente che chiama utilizzando me anziché un indirizzo email come in accounts/{account}/users/me.

DeliveryTime

Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto.

Campi
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Facoltativo. Indica che il tempo di consegna deve essere calcolato in base al magazzino (località di partenza della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non deve essere impostato nessun altro campo relativo al tempo di transito in [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime].
min_transit_days

int32

Numero minimo di giorni lavorativi di transito. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo. È necessario impostare min_transit_days, max_transit_days o transit_time_table, ma non entrambi.
max_transit_days

int32

Numero massimo di giorni lavorativi di transito. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo. Deve essere maggiore o uguale a min_transit_days.
cutoff_time

CutoffTime

Definizione dell'ora limite dei giorni lavorativi. Se non è configurato, l'ora di interruzione sarà impostata su 08:00 PST.
min_handling_days

int32

Numero minimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. "min_handling_days" e "max_handling_days" devono essere impostati o non impostati contemporaneamente.
max_handling_days

int32

Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 indica la spedizione in giornata, 1 indica la spedizione il giorno successivo. Deve essere maggiore o uguale a min_handling_days. "min_handling_days" e "max_handling_days" devono essere impostati o non impostati contemporaneamente.
transit_time_table

TransitTable

Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi impostare min_transit_days, max_transit_days o transit_time_table, ma non entrambi.
handling_business_day_config

BusinessDayConfig

I giorni lavorativi durante i quali è possibile gestire gli ordini. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì.
transit_business_day_config

BusinessDayConfig

I giorni lavorativi durante i quali gli ordini possono essere in transito. Se non viene fornito, si presume che i giorni lavorativi siano da lunedì a venerdì.

DisableProgramRequest

Messaggio di richiesta per il metodo DisableProgram.

Campi
name

string

Obbligatorio. Il nome del programma per cui disattivare la partecipazione per l'account specificato. Formato: accounts/{account}/programs/{program}

Distanza

Raggio di consegna massimo. Questo è necessario solo per il tipo di spedizione con consegna locale.

Campi
value

int64

Valore intero della distanza.
unit

Unit

L'unità può variare in base al paese ed è parametrizzata in modo da includere miglia e chilometri.

Unità

L'unità può variare in base al paese ed è parametrizzata per includere miglia e chilometri.

Enum
UNIT_UNSPECIFIED Unità non specificata
MILES Unità in miglia
KILOMETERS Unità in chilometri

EmailPreferences

Le categorie di notifiche attivate / disattivate dall'utente. Le preferenze email non includono gli annunci obbligatori, in quanto gli utenti non possono disattivarli.

Campi
name

string

Identificatore. Il nome di EmailPreferences. L'endpoint è supportato solo per l'utente autenticato.
news_and_tips

OptInState

Facoltativo. Aggiornamenti su nuove funzionalità, suggerimenti e best practice.

OptInState

Stato di attivazione della preferenza email.

Enum
OPT_IN_STATE_UNSPECIFIED Lo stato di attivazione non è specificato.
OPTED_OUT L'utente ha disattivato la ricezione di questo tipo di email.
OPTED_IN L'utente ha attivato la ricezione di questo tipo di email.
UNCONFIRMED L'utente ha attivato la ricezione di questo tipo di email e l'email di conferma è stata inviata, ma l'utente non ha ancora confermato l'attivazione (si applica solo a determinati paesi).

EnableProgramRequest

Messaggio di richiesta per il metodo EnableProgram.

Campi
name

string

Obbligatorio. Il nome del programma per cui attivare la partecipazione per l'account specificato. Formato: accounts/{account}/programs/{program}

GetAccountRequest

Messaggio di richiesta per il metodo GetAccount.

Campi
name

string

Obbligatorio. Il nome dell'account da recuperare. Formato: accounts/{account}

GetAutofeedSettingsRequest

Messaggio di richiesta per il metodo GetAutofeedSettings.

Campi
name

string

Obbligatorio. Il nome della risorsa delle impostazioni del feed automatico. Formato: accounts/{account}/autofeedSettings

GetBusinessIdentityRequest

Messaggio di richiesta per il metodo GetBusinessIdentity.

Campi
name

string

Obbligatorio. Il nome della risorsa dell'identità dell'attività. Formato: accounts/{account}/businessIdentity

GetBusinessInfoRequest

Messaggio di richiesta per il metodo GetBusinessInfo.

Campi
name

string

Obbligatorio. Il nome della risorsa delle informazioni sull'attività. Formato: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Messaggio di richiesta per il metodo GetEmailPreferences.

Campi
name

string

Obbligatorio. Il nome della risorsa EmailPreferences. Formato: accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Messaggio di richiesta per il metodo GetHomepage.

Campi
name

string

Obbligatorio. Il nome della home page da recuperare. Formato: accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Messaggio di richiesta per il metodo GetOnlineReturnPolicy.

Campi
name

string

Obbligatorio. Il nome delle norme sui resi da recuperare. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Messaggio di richiesta per il metodo GetProgram.

Campi
name

string

Obbligatorio. Il nome del programma da recuperare. Formato: accounts/{account}/programs/{program}

GetRegionRequest

Messaggio di richiesta per il metodo GetRegion.

Campi
name

string

Obbligatorio. Il nome della regione da recuperare. Formato: accounts/{account}/regions/{region}

GetShippingSettingsRequest

Messaggio di richiesta per il metodo GetShippingSetting.

Campi
name

string

Obbligatorio. Il nome dell'impostazione di spedizione da recuperare. Formato: accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Messaggio di richiesta per il metodo GetTermsOfServiceAgreementState.

Campi
name

string

Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} Il formato dell'identificatore è: {TermsOfServiceKind}-{country}

GetTermsOfServiceRequest

Messaggio di richiesta per il metodo GetTermsOfService.

Campi
name

string

Obbligatorio. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}

GetUserRequest

Messaggio di richiesta per il metodo GetUser.

Campi
name

string

Obbligatorio. Il nome dell'utente da recuperare. Formato: accounts/{account}/users/{email}

È anche possibile recuperare l'utente corrispondente all'utente chiamante utilizzando me anziché un indirizzo email come in accounts/{account}/users/me.

Intestazioni

Un elenco non vuoto di intestazioni di riga o colonna per una tabella. Deve essere impostato esattamente uno dei valori prices, weights, num_items, postal_code_group_names o location.

Campi
prices[]

Price

Obbligatorio. Un elenco di limiti superiori del prezzo dell'ordine inclusi. Il valore dell'ultimo prezzo può essere infinito impostando price amount_micros = -1. Ad esempio, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] rappresenta le intestazioni "<= 10 $", "<= 500 $" e "> 500 $". Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. Non deve essere vuoto. Deve essere positivo, tranne -1. Può essere impostato solo se non sono impostati tutti gli altri campi.
weights[]

Weight

Obbligatorio. Un elenco di limiti superiori del peso dell'ordine inclusivi. Il valore dell'ultimo peso può essere infinito impostando price amount_micros = -1. Ad esempio, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] rappresenta le intestazioni "<= 10 kg", "<= 50 kg" e "> 50 kg". Tutti i pesi all'interno di un servizio devono avere la stessa unità di misura. Non deve essere vuoto. Deve essere positivo, tranne -1. Può essere impostato solo se non sono impostati tutti gli altri campi.
number_of_items[]

string

Obbligatorio. Un elenco di limiti superiori inclusivi del numero di articoli. L'ultimo valore può essere "infinity". Ad esempio, ["10", "50", "infinity"] rappresenta le intestazioni "<= 10 elementi", "<= 50 elementi" e "> 50 elementi". Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.
postal_code_group_names[]

string

Obbligatorio. Un elenco di nomi di gruppi postali. L'ultimo valore può essere "all other locations". Esempio: ["zone 1", "zone 2", "all other locations"]. I gruppi di codici postali a cui si fa riferimento devono corrispondere al paese di consegna del servizio. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.
locations[]

LocationIdSet

Obbligatorio. Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.

Home page

Il messaggio Homepage rappresenta la home page del negozio di un commerciante all'interno del sistema.

La home page di un commerciante è il dominio principale in cui i clienti interagiscono con il suo negozio.

La home page può essere rivendicata e verificata come prova della proprietà e consente al commerciante di sbloccare le funzionalità che richiedono un sito web verificato. Per saperne di più, consulta Informazioni sulla verifica dell'URL del negozio online.

Campi
name

string

Identificatore. Il nome della risorsa della home page del negozio. Formato: accounts/{account}/homepage
claimed

bool

Solo output. Indica se la home page è rivendicata. Vedi https://support.google.com/merchants/answer/176793.
uri

string

Obbligatorio. L'URI (in genere un URL) della home page del negozio.

InsertShippingSettingsRequest

Messaggio di richiesta per il metodo InsertShippingSetting.

Campi
parent

string

Obbligatorio. L'account in cui verrà inserito questo prodotto. Formato: accounts/{account}
shipping_setting

ShippingSettings

Obbligatorio. La nuova versione dell'account.

ListAccountIssuesRequest

Messaggio di richiesta per il metodo ListAccountIssues.

Campi
parent

string

Obbligatorio. L'elemento principale, proprietario di questa raccolta di problemi. Formato: accounts/{account}
page_size

int32

Facoltativo. Il numero massimo di problemi da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 50 utenti. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListAccountIssues precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListAccountIssues devono corrispondere alla chiamata che ha fornito il token pagina.
language_code

string

Facoltativo. I problemi nella risposta avranno campi leggibili nella lingua specificata. Il formato è BCP-47, ad esempio en-US o sr-Latn. Se non viene fornito alcun valore, verrà utilizzato en-US.
time_zone

string

Facoltativo. Il fuso orario IANA utilizzato per localizzare le ore in campi leggibili. Ad esempio "America/Los_Angeles". Se non viene impostato, verrà utilizzato "America/Los_Angeles".

ListAccountIssuesResponse

Messaggio di risposta per il metodo ListAccountIssues.

Campi
account_issues[]

AccountIssue

I problemi dell'account specificato.
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.

ListAccountsRequest

Messaggio di richiesta per il metodo ListAccounts.

Campi
page_size

int32

Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 vengono forzati a 500.
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListAccounts precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token pagina.
filter

string

Facoltativo. Restituisce solo gli account che corrispondono al filtro. Per ulteriori dettagli, consulta la documentazione di riferimento sulla sintassi dei filtri.

ListAccountsResponse

Messaggio di risposta per il metodo ListAccounts.

Campi
accounts[]

Account

Gli account corrispondenti a ListAccountsRequest.
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.

ListOnlineReturnPoliciesRequest

Messaggio di richiesta per il metodo ListOnlineReturnPolicies.

Campi
parent

string

Obbligatorio. L'account commerciante per cui elencare le norme sui resi. Formato: accounts/{account}
page_size

int32

Facoltativo. Il numero massimo di risorse OnlineReturnPolicy da restituire. Il servizio restituisce un numero inferiore a questo valore se il numero di norme sui resi per il commerciante in questione è inferiore a pageSize. Il valore predefinito è 10. Il valore massimo è 100. Se viene specificato un valore superiore al massimo, per pageSize verrà utilizzato il valore massimo per impostazione predefinita
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListOnlineReturnPolicies precedente. Fornisci il token di pagina per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListOnlineReturnPolicies devono corrispondere alla chiamata che ha fornito il token pagina. Il token restituito come nextPageToken nella risposta alla richiesta precedente.

ListOnlineReturnPoliciesResponse

Messaggio di risposta per il metodo ListOnlineReturnPolicies.

Campi
online_return_policies[]

OnlineReturnPolicy

Le norme sui resi recuperate.
next_page_token

string

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

ListProgramsRequest

Messaggio di richiesta per il metodo ListPrograms.

Campi
parent

string

Obbligatorio. Il nome dell'account per cui recuperare tutti i programmi. Formato: accounts/{account}
page_size

int32

Facoltativo. Il numero massimo di programmi da restituire in una singola risposta. Se non specificato (o 0), viene utilizzata una dimensione predefinita di 1000. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
page_token

string

Facoltativo. Un token di continuazione ricevuto da una chiamata ListPrograms precedente. Fornisci questo codice per recuperare la pagina successiva.

ListProgramsResponse

Messaggio di risposta per il metodo ListPrograms.

Campi
programs[]

Program

I programmi per l'account specificato.
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.

ListRegionsRequest

Messaggio di richiesta per il metodo ListRegions.

Campi
parent

string

Obbligatorio. L'account per cui elencare le regioni. Formato: accounts/{account}
page_size

int32

Facoltativo. Il numero massimo di regioni da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituite al massimo 50 regioni. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListRegions precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListRegions devono corrispondere alla chiamata che ha fornito il token pagina.

ListRegionsResponse

Messaggio di risposta per il metodo ListRegions.

Campi
regions[]

Region

Le regioni del commerciante specificato.
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.

ListSubAccountsRequest

Messaggio di richiesta per il metodo ListSubAccounts.

Campi
provider

string

Obbligatorio. Il fornitore di servizi di aggregazione. Formato: providers/{providerId}
page_size

int32

Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, vengono restituiti al massimo 250 account. Il valore massimo è 500; i valori superiori a 500 vengono forzati a 500.
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListAccounts precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token pagina.

ListSubAccountsResponse

Messaggio di risposta per il metodo ListSubAccounts.

Campi
accounts[]

Account

Gli account per i quali l'account genitore specificato è un aggregatore.
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.

ListUsersRequest

Messaggio di richiesta per il metodo ListUsers.

Campi
parent

string

Obbligatorio. Il gruppo principale, proprietario di questa raccolta di utenti. Formato: accounts/{account}
page_size

int32

Facoltativo. Il numero massimo di utenti da restituire. Il servizio potrebbe restituire meno di questo valore. Se non specificato, verranno restituiti al massimo 50 utenti. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100
page_token

string

Facoltativo. Un token di pagina ricevuto da una chiamata ListUsers precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListUsers devono corrispondere alla chiamata che ha fornito il token pagina.

ListUsersResponse

Messaggio di risposta per il metodo ListUsers.

Campi
users[]

User

Gli utenti dell'account specificato.
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.

LocationIdSet

Un elenco di insiemi di ID posizione. Non deve essere vuoto. Può essere impostato solo se non sono impostati tutti gli altri campi.

Campi
location_ids[]

string

Obbligatorio. Un elenco non vuoto di ID posizione. Devono essere tutti dello stesso tipo di località (ad esempio stato).

MinimumOrderValueTable

Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini con ritiro in negozio.

Campi
store_code_set_with_movs[]

StoreCodeSetWithMov

Obbligatorio. Un elenco di insiemi di codici identificativi del negozio che condividono lo stesso valore minimo dell'ordine. Sono necessari almeno due insiemi e l'ultimo deve essere vuoto, il che significa "MOV per tutti gli altri negozi". Ogni codice negozio può essere visualizzato una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta.

StoreCodeSetWithMov

Un elenco di set di codici negozio che condividono lo stesso valore minimo dell'ordine. Sono necessari almeno due insiemi e l'ultimo deve essere vuoto, il che significa "MOV per tutti gli altri negozi". Ogni codice negozio può essere visualizzato una sola volta in tutti i set. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta.

Campi
store_codes[]

string

Facoltativo. Un elenco di codici negozio univoci o vuoto per il valore generico.
value

Price

Il valore minimo dell'ordine per i negozi specificati.

OnlineReturnPolicy

Oggetto Norme sui resi online. Attualmente viene utilizzato per rappresentare le norme sui resi per i programmi di annunci e schede senza costi.

Campi
name

string

Identificatore. Il nome della risorsa OnlineReturnPolicy. Formato: accounts/{account}/onlineReturnPolicies/{return_policy}
return_policy_id

string

Solo output. ID delle norme sui resi generato da Google.
label

string

Obbligatorio. Immutabile. Questo campo rappresenta l'etichetta univoca definita dall'utente delle norme sui resi. È importante notare che la stessa etichetta non può essere utilizzata in norme sui resi diverse per lo stesso paese. A meno che un prodotto non specifichi un attributo etichetta specifico, i criteri verranno etichettati automaticamente come "predefiniti". Per assegnare norme sui resi personalizzate a determinati gruppi di prodotti, segui le istruzioni riportate nella sezione Etichetta delle norme sui resi. L'etichetta può contenere fino a 50 caratteri.
countries[]

string

Obbligatorio. Immutabile. I paesi di vendita in cui si applicano le norme sui resi. I valori devono essere un codice ISO 3166 di due lettere valido.
policy

Policy

Le norme sui resi.
seasonal_overrides[]

SeasonalOverride

Facoltativo. Sostituzione dei criteri generali per gli ordini effettuati durante un insieme specifico di intervalli di tempo.
restocking_fee

RestockingFee

La commissione di riassortimento che si applica a tutte le categorie di motivi del reso. Se il valore non è impostato, verrà trattata come una tariffa di riassortimento senza costi.
return_methods[]

ReturnMethod

I metodi di reso a disposizione dei clienti per restituire un articolo. Questo valore non deve essere vuoto, a meno che il tipo di norme sui resi non sia noReturns.
item_conditions[]

ItemCondition

Le condizioni dell'articolo accettate per i resi non devono essere vuote, a meno che il tipo di norme sui resi non sia "noReturns".
return_shipping_fee

ReturnShippingFee

La tariffa di spedizione del reso. Deve essere impostato solo quando il cliente deve scaricare e stampare l'etichetta di reso.
return_policy_uri

string

Obbligatorio. L'URI delle norme sui resi. Google può utilizzarlo per eseguire un controllo di congruità delle norme. Deve essere un URL valido.
accept_defective_only

bool

Questo campo specifica se il commerciante accetta solo i prodotti con problemi per i resi ed è obbligatorio.
process_refund_days

int32

Il campo specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi. È facoltativo.
accept_exchange

bool

Questo campo specifica se il commerciante consente ai clienti di cambiare i prodotti. È obbligatorio.

ItemCondition

Le condizioni degli articoli disponibili.

Enum
ITEM_CONDITION_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NEW Nuovo.
USED Usato.

Norme

I criteri disponibili.

Campi
type

Type

Tipo di criterio.
days

int64

Il numero di giorni entro cui è possibile restituire gli articoli dopo la consegna, dove un giorno è definito come 24 ore dopo il timestamp della consegna. Obbligatorio per i resi di NUMBER_OF_DAYS_AFTER_DELIVERY.

Tipo

Tipi di norme sui resi.

Enum
TYPE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NUMBER_OF_DAYS_AFTER_DELIVERY Il numero di giorni entro i quali un reso è valido dopo la consegna.
NO_RETURNS Nessun reso.
LIFETIME_RETURNS Resi illimitati.

RestockingFee

La commissione di riassortimento. Può trattarsi di una tariffa fissa o di una micropercentuale.

Campi

Campo unione type.

type può essere solo uno dei seguenti:
fixed_fee

Price

Commissione di riassortimento fissa.
micro_percent

int32

Percentuale del prezzo totale in micro. 15.000.000 significa che verrà addebitato il 15% del prezzo totale.

ReturnMethod

I metodi di reso disponibili.

Enum
RETURN_METHOD_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
BY_MAIL Restituire il dispositivo per posta.
IN_STORE Restituire l'articolo in negozio.
AT_A_KIOSK Restituire il dispositivo presso un chiosco.

ReturnShippingFee

La tariffa di spedizione del reso. Può essere una tariffa fissa o un valore booleano per indicare che il cliente paga il costo di spedizione effettivo.

Campi
type

Type

Obbligatorio. Tipo di tariffa di spedizione reso.
fixed_fee

Price

Importo fisso della tariffa di spedizione del reso. Questo valore è applicabile solo quando il tipo è FIXED. Tratteremo la tariffa di spedizione del reso come senza costi se il tipo è FIXED e questo valore non è impostato.

Tipo

Tipi di tariffe di spedizione reso.

Enum
TYPE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
FIXED La tariffa di spedizione del reso è un valore fisso.
CUSTOMER_PAYING_ACTUAL_FEE I clienti pagheranno la tariffa di spedizione del reso effettiva.

SeasonalOverride

Avanti: 5

Campi
label

string

Obbligatorio. Nome visualizzato di questa sostituzione stagionale in Merchant Center.
begin

Date

Obbligatorio. Definisce l'intervallo di date in cui si applica questa sostituzione stagionale. Sia inizio che fine sono inclusi e devono essere in formato decimale della data, ad esempio 20250115. Le date delle sostituzioni stagionali non devono sovrapporsi.
end

Date

Obbligatorio. Data di fine della variazione stagionale (inclusa).
policy

Policy

Obbligatorio. Le norme sui resi per l'intervallo di date specificato.

PhoneVerificationState

Lo stato della verifica telefonica.

Enum
PHONE_VERIFICATION_STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
PHONE_VERIFICATION_STATE_VERIFIED Lo smartphone è verificato.
PHONE_VERIFICATION_STATE_UNVERIFIED Lo smartphone non è verificato

Programma

Definisce la partecipazione a un determinato programma per l'account specificato.

I programmi forniscono un meccanismo per aggiungere funzionalità agli account commerciante. Un esempio tipico è il programma Schede di prodotto senza costi, che consente di mostrare i prodotti del negozio di un commerciante senza costi su Google.

Campi
name

string

Identificatore. Il nome della risorsa del programma. Formato: accounts/{account}/programs/{program}
documentation_uri

string

Solo output. L'URL di una pagina di assistenza di Merchant Center che descrive il programma.
state

State

Solo output. Lo stato di partecipazione dell'account al programma.
active_region_codes[]

string

Solo output. Le regioni in cui l'account partecipa attivamente al programma. Le regioni attive sono quelle in cui sono stati soddisfatti tutti i requisiti del programma che le interessano.

I codici regione sono definiti da CLDR. Può essere un paese in cui il programma si applica specificamente o 001 se il programma si applica a livello globale.
unmet_requirements[]

Requirement

Solo output. I requisiti che l'account non ha ancora soddisfatto e che influiscono sulla partecipazione al programma.

Requisito

Definisce un requisito specificato per la partecipazione al programma.

Campi
title

string

Solo output. Nome del requisito.
documentation_uri

string

Solo output. L'URL di una pagina di assistenza che descrive il requisito.
affected_region_codes[]

string

Solo output. Le regioni attualmente interessate dal mancato rispetto di questo requisito.

I codici regione sono definiti da CLDR. Può essere un paese in cui il programma si applica specificamente a quel paese o 001 se il programma si applica a livello globale.

Stato

Possibili stati di partecipazione al programma per l'account.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
NOT_ELIGIBLE L'account non è idoneo a partecipare al programma.
ELIGIBLE L'account è idoneo a partecipare al programma.
ENABLED Il programma è abilitato per l'account.

RateGroup

Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un applicable_shipping_labels vuoto, che significa "tutto il resto". L'altro applicable_shipping_labels non deve sovrapporsi.

Campi
applicable_shipping_labels[]

string

Obbligatorio. Un elenco di etichette di spedizione che definiscono i prodotti a cui si applica questo gruppo di tariffe. Si tratta di una disgiunzione: per l'applicazione del gruppo di tariffe è sufficiente che corrisponda una delle etichette. Può essere vuoto solo per l'ultimo gruppo di tariffe di un servizio.
subtables[]

Table

Facoltativo. Un elenco di sottotabelle a cui fa riferimento main_table. Può essere impostato solo se è impostato main_table.
carrier_rates[]

CarrierRate

Facoltativo. Un elenco di tariffe dell'operatore a cui è possibile fare riferimento tramite main_table o single_value.
single_value

Value

Il valore del gruppo di tariffe (ad es. tariffa fissa 10 $). Può essere impostato solo se main_table e subtables non sono impostati.
main_table

Table

Una tabella che definisce il gruppo di tariffe, quando single_value non è sufficientemente espressivo. Può essere impostato solo se single_value non è impostato.
name

string

Facoltativo. Nome del gruppo di tariffe. Se impostato, deve essere univoco all'interno del servizio di spedizione.

Regione

Rappresenta una regione geografica che puoi utilizzare come target sia con i servizi RegionalInventory sia con ShippingSettings. Puoi definire le regioni come raccolte di codici postali o, in alcuni paesi, utilizzando i geotarget predefiniti. Per ulteriori informazioni, consulta Configurare le regioni .

Campi
name

string

Identificatore. Il nome della risorsa della regione. Formato: accounts/{account}/regions/{region}
postal_code_area

PostalCodeArea

Facoltativo. Un elenco di codici postali che definisce l'area della regione.
geotarget_area

GeoTargetArea

Facoltativo. Un elenco di target geografici che definisce l'area della regione.
regional_inventory_eligible

BoolValue

Solo output. Indica se la regione è idonea per l'utilizzo nella configurazione dell'inventario regionale.
shipping_eligible

BoolValue

Solo output. Indica se la regione è idonea per l'utilizzo nella configurazione dei servizi di spedizione.
display_name

string

Facoltativo. Il nome visualizzato della regione.

GeoTargetArea

Un elenco di target geografici che definisce l'area della regione.

Campi
geotarget_criteria_ids[]

int64

Obbligatorio. Un elenco non vuoto di ID posizione. Devono essere tutti dello stesso tipo di località (ad esempio stato).

PostalCodeArea

Un elenco di codici postali che definisce l'area della regione. Nota: tutte le regioni definite utilizzando i codici postali sono accessibili tramite la risorsa ShippingSettings.postalCodeGroups dell'account.

Campi
region_code

string

Obbligatorio. Codice di territorio CLDR o il paese a cui si applica il gruppo di codici postali.
postal_codes[]

PostalCodeRange

Obbligatorio. Un intervallo di codici postali.

PostalCodeRange

Un intervallo di codici postali che definisce l'area della regione.

Campi
begin

string

Obbligatorio. Un codice postale o un pattern del prefisso del modulo* che indica il limite inferiore incluso dell'intervallo che definisce l'area. Valori di esempio: 94108, 9410*, 9*.
end

string

Facoltativo. Un codice postale o un pattern del tipo prefix* che indica il limite superiore incluso dell'intervallo che definisce l'area. Deve avere la stessa lunghezza di postalCodeRangeBegin: se postalCodeRangeBegin è un codice postale, anche postalCodeRangeEnd deve essere un codice postale; se postalCodeRangeBegin è un pattern, anche postalCodeRangeEnd deve essere un pattern con la stessa lunghezza del prefisso. Facoltativo: se non impostato, l'area è definita come tutti i codici postali corrispondenti a postalCodeRangeBegin.

Obbligatorio

Descrive i Termini di servizio che devono essere accettati.

Campi
terms_of_service

string

I termsOfService che devono essere accettati.
tos_file_uri

string

URL completo del file dei Termini di servizio. Questo campo è uguale a TermsOfService.file_uri, ma è stato aggiunto qui solo per comodità.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Messaggio di richiesta per il metodo RetrieveForApplicationTermsOfServiceAgreementState.

Campi
parent

string

Obbligatorio. L'account per cui ottenere un formato TermsOfServiceAgreementState: accounts/{account}

RetrieveLatestTermsOfServiceRequest

Messaggio di richiesta per il metodo RetrieveLatestTermsOfService.

Campi
region_code

string

Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese quando i TdS si applicano specificamente a quel paese o di 001 quando si applicano a livello globale.
kind

TermsOfServiceKind

Obbligatorio. Il tipo a cui si applica questa versione dei Termini di servizio.

Riga

Includi un elenco di celle.

Campi
cells[]

Value

Obbligatorio. L'elenco di celle che costituiscono la riga. Deve avere la stessa lunghezza di columnHeaders per le tabelle bidimensionali e una lunghezza di 1 per le tabelle unidimensionali.

Servizio

Servizio di spedizione.

Campi
delivery_countries[]

string

Obbligatorio. Il codice di territorio CLDR dei paesi a cui si applica il servizio.
rate_groups[]

RateGroup

Facoltativo. Definizioni dei gruppi di tariffe di spedizione. Solo l'ultimo può avere un applicable_shipping_labels vuoto, che significa "tutto il resto". L'altro applicable_shipping_labels non deve sovrapporsi.
loyalty_programs[]

LoyaltyProgram

Facoltativo. Programmi fedeltà a cui è limitato questo servizio di spedizione.
service_name

string

Obbligatorio. Nome libero del servizio. Deve essere univoco all'interno dell'account di destinazione.
active

bool

Obbligatorio. Un valore booleano che mostra lo stato attivo del servizio di spedizione.
currency_code

string

Il codice CLDR della valuta a cui si applica questo servizio. Deve corrispondere a quello dei prezzi nei gruppi di tariffe.
delivery_time

DeliveryTime

Obbligatorio. Tempo impiegato per vari aspetti, dall'ordine alla consegna del prodotto.
shipment_type

ShipmentType

Tipo di località in cui questo servizio spedisce gli ordini.
minimum_order_value

Price

Valore minimo dell'ordine per questo servizio. Se impostato, indica che i clienti dovranno spendere almeno questo importo. Tutti i prezzi all'interno di un servizio devono avere la stessa valuta. Non può essere impostato insieme a minimum_order_value_table.
minimum_order_value_table

MinimumOrderValueTable

Tabella dei valori minimi degli ordini per negozio per il tipo di evasione degli ordini con ritiro in negozio. Non può essere impostato insieme a minimum_order_value.
store_config

StoreConfig

Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di consegna locale.

LoyaltyProgram

Programma fedeltà fornito da un commerciante.

Campi
loyalty_program_tiers[]

LoyaltyProgramTiers

Facoltativo. Livello del programma fedeltà di questo servizio di spedizione.
program_label

string

Si tratta dell'etichetta del programma fedeltà configurata nelle impostazioni del programma fedeltà in Merchant Center. Questo attributo secondario consente a Google di mappare il tuo programma fedeltà alle offerte idonee.

LoyaltyProgramTiers

Sottoinsieme di un programma fedeltà dei commercianti.

Campi
tier_label

string

L'attributo secondario etichetta del livello [tier_label] differenzia i vantaggi di ciascun livello dell'offerta. Questo valore è configurato anche nelle impostazioni del programma in Merchant Center ed è obbligatorio per le modifiche alle origini dati anche se il programma fedeltà ha un solo livello.

ShipmentType

Tipo di spedizione del servizio di spedizione.

Enum
SHIPMENT_TYPE_UNSPECIFIED Questo servizio non ha specificato il tipo di spedizione.
DELIVERY Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente.
LOCAL_DELIVERY Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un negozio locale nelle vicinanze.
COLLECTION_POINT Questo servizio spedisce gli ordini a un indirizzo scelto dal cliente. L'ordine viene spedito da un punto di ritiro.

StoreConfig

Un elenco dei negozi da cui vengono consegnati i tuoi prodotti. Questo vale solo per il tipo di spedizione di consegna locale.

Campi
store_codes[]

string

Facoltativo. Un elenco di codici negozio che offrono la consegna locale. Se vuoto, all_stores deve essere true.
store_service_type

StoreServiceType

Indica se tutti i negozi o negozi selezionati elencati da questo commerciante offrono la consegna locale.
cutoff_config

CutoffConfig

Le configurazioni relative alla consegna locale terminano per la giornata.
service_radius

Distance

Raggio di consegna massimo. Questo è necessario solo per il tipo di spedizione con consegna locale.

CutoffConfig

Le configurazioni relative alla consegna locale terminano per la giornata.

Campi
local_cutoff_time

LocalCutoffTime

Ora di fine della consegna locale per la giornata.
store_close_offset_hours

int64

Valido solo con l'evasione degli ordini locali. Rappresenta l'ora limite come numero di ore prima della chiusura del negozio. Si escludono a vicenda con local_cutoff_time.
no_delivery_post_cutoff

bool

I commercianti possono disattivare la visualizzazione della consegna locale in n+1 giorni se hanno configurato un servizio di spedizione con consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed è trascorso il limite, l'impostazione di questo campo su true fa sì che la tariffa del servizio di spedizione calcolata restituisca NO_DELIVERY_POST_CUTOFF. Nello stesso esempio, se imposti questo campo su false, il tempo di spedizione calcolato sarà di un giorno. Questo vale solo per la consegna locale.

LocalCutoffTime

Ora di fine della consegna locale per la giornata.

Campi
hour

int64

Gli ordini con consegna locale devono essere effettuati entro questa ora per essere elaborati lo stesso giorno.
minute

int64

Gli ordini con consegna locale devono essere effettuati entro questo orario per essere elaborati lo stesso giorno.

StoreServiceType

Indica se tutti i negozi o negozi selezionati elencati dal commerciante offrono la consegna locale.

Enum
STORE_SERVICE_TYPE_UNSPECIFIED Non è stato specificato il tipo di servizio del negozio.
ALL_STORES Indica se tutti i negozi, attuali e futuri, elencati da questo commerciante offrono la consegna locale.
SELECTED_STORES Indica che solo i negozi elencati in store_codes sono idonei per la consegna locale.

ShippingSettings

Le impostazioni di spedizione dell'account commerciante.

Campi
name

string

Identificatore. Il nome della risorsa dell'impostazione di spedizione. Formato: accounts/{account}/shippingSetting
services[]

Service

Facoltativo. L'elenco dei servizi dell'account di destinazione.
warehouses[]

Warehouse

Facoltativo. Un elenco di magazzini a cui fare riferimento in services.
etag

string

Obbligatorio. Questo campo viene utilizzato per evitare problemi di accoppiamento asincrono. Assicurati che i dati delle impostazioni di spedizione non siano cambiati tra la chiamata get e la chiamata insert. L'utente deve seguire i seguenti passaggi:

  1. Imposta il campo etag come stringa vuota per la creazione iniziale dell'impostazione di spedizione.

  2. Dopo la creazione iniziale, chiama il metodo get per ottenere un etag e i dati delle impostazioni di spedizione correnti prima di chiamare insert.

  3. Modifica le informazioni sulle impostazioni di spedizione che ti interessano.

  4. Chiama il metodo di inserimento con le informazioni sulle impostazioni di spedizione desiderate e l'etag ottenuto nel passaggio 2.

  5. Se i dati delle impostazioni di spedizione sono cambiati tra il passaggio 2 e il passaggio 4. La richiesta di inserimento non andrà a buon fine perché l'etag cambia ogni volta che cambiano i dati dell'impostazione di spedizione. L'utente deve ripetere i passaggi 2-4 con il nuovo etag.

Tabella

Una tabella che definisce il gruppo di tariffe, quando single_value non è sufficientemente espressivo.

Campi
rows[]

Row

Obbligatorio. L'elenco di righe che costituiscono la tabella. Deve avere la stessa lunghezza di row_headers.
name

string

Nome della tabella. Obbligatorio per le sottotabelle, ignorato per la tabella principale.
row_headers

Headers

Obbligatorio. Intestazioni delle righe della tabella.
column_headers

Headers

Intestazioni delle colonne della tabella. Facoltativo: se non impostato, la tabella ha una sola dimensione.

TermsOfService

Il messaggio TermsOfService indica una versione specifica dei Termini di servizio che i commercianti devono accettare per accedere a determinate funzionalità o servizi (vedi https://support.google.com/merchants/answer/160173).

Questo messaggio è importante per la procedura di onboarding, in quanto garantisce che i commercianti accettino i contratti legali necessari per l'utilizzo del servizio. I commercianti possono recuperare i Termini di servizio più recenti per un determinato kind e region tramite RetrieveLatestTermsOfService e accettarli come richiesto tramite AcceptTermsOfService.

Campi
name

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: termsOfService/{version}
region_code

string

Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese o 001 quando lo stesso TermsOfService può essere firmato in qualsiasi paese. Tuttavia, tieni presente che, quando firmi un contratto di servizio che si applica a livello globale, ci aspettiamo comunque che venga fornito un paese specifico (che deve essere il paese in cui ha sede l'attività commerciale del commerciante o il paese di partecipazione al programma).
kind

TermsOfServiceKind

Il tipo a cui si applica questa versione dei Termini di servizio.
external

bool

Indica se questa versione dei Termini di servizio è esterna. Le versioni dei Termini di servizio esterni possono essere accettate solo tramite procedure esterne e non direttamente dal commerciante tramite UI o API.
file_uri

string

URI del file dei Termini di servizio che deve essere mostrato agli utenti che li firmano.

TermsOfServiceAgreementState

Questa risorsa rappresenta lo stato del contratto per un determinato account e tipo di Termini di servizio. Lo stato è il seguente:

  • Se il commerciante ha accettato i Termini di servizio, il valore accepted verrà inserito, altrimenti sarà vuoto
  • Se il commerciante deve firmare i Termini di servizio, il campo required verrà compilato, altrimenti rimarrà vuoto.

Tieni presente che possono essere presenti sia required che accepted. In questo caso, i termini di servizio accepted avranno una data di scadenza impostata nel campo valid_until. I Termini di servizio di required devono essere accettati prima del giorno valid_until affinché il contratto dell'account rimanga valido. Quando accettano i nuovi Termini di servizio, ci aspettiamo che le terze parti mostrino il testo associato al contratto relativo ai Termini di servizio specificati (l'URL del file contenente il testo viene aggiunto nel messaggio obbligatorio di seguito come tos_file_uri. L'accettazione effettiva dei Termini di servizio viene eseguita chiamando accept sulla risorsa TermsOfService.

Campi
name

string

Identificatore. Il nome della risorsa della versione dei Termini di servizio. Formato: accounts/{account}/termsOfServiceAgreementState/{identifier} Il formato dell'identificatore è: {TermsOfServiceKind}-{country} Ad esempio, un identificatore potrebbe essere: MERCHANT_CENTER-US
region_code

string

Codice regione come definito da https://cldr.unicode.org/. Si tratta del paese a cui si applica lo stato attuale.
terms_of_service_kind

TermsOfServiceKind

Tipo di Termini di servizio associati alla versione specifica.
accepted

Accepted

I Termini di servizio accettati di questo tipo e per il codice region_code associato
required

Required

I Termini di servizio obbligatori

TermsOfServiceKind

Il tipo TermsOfService.

Enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
MERCHANT_CENTER Applicazione Merchant Center.

TransitTable

Tabella del tempo di transito, numero di giorni lavorativi trascorsi in transito in base alle dimensioni di riga e colonna. Puoi impostare min_transit_days, max_transit_days o transit_time_table, ma non entrambi.

Campi
postal_code_group_names[]

string

Obbligatorio. Un elenco di nomi di regioni Region.name . L'ultimo valore può essere "all other locations". Esempio: ["zone 1", "zone 2", "all other locations"]. I gruppi di codici postali a cui fai riferimento devono corrispondere al paese di consegna del servizio.
transit_time_labels[]

string

Obbligatorio. Un elenco di etichette del tempo di transito. L'ultimo valore può essere "all other labels". Esempio: ["food", "electronics", "all other labels"].
rows[]

TransitTimeRow

Obbligatorio. Se è presente un solo insieme di dimensioni di postal_code_group_names o transit_time_labels, esistono più righe con un valore per ogni dimensione. Se sono presenti due dimensioni, ogni riga corrisponde a un postal_code_group_names e le colonne (valori) a un transit_time_labels.

TransitTimeRow

Se è presente un solo insieme di dimensioni di postal_code_group_names o transit_time_labels, esistono più righe con un valore per ogni dimensione. Se sono presenti due dimensioni, ogni riga corrisponde a un postal_code_group_names e le colonne (valori) a un transit_time_labels.

Campi
values[]

TransitTimeValue

Obbligatorio. Intervallo di tempo di transito (min-max) in giorni lavorativi.

TransitTimeValue

Intervallo di tempo di transito (min-max) in giorni lavorativi.

Campi
min_transit_days

int32

Intervallo di tempo di transito minimo in giorni lavorativi. 0 indica la consegna in giornata, 1 indica la consegna il giorno successivo.
max_transit_days

int32

Deve essere maggiore o uguale a min_transit_days.

UnclaimHomepageRequest

Messaggio di richiesta per il metodo UnclaimHomepage.

Campi
name

string

Obbligatorio. Il nome della home page di cui revocare la rivendicazione. Formato: accounts/{account}/homepage

UpdateAccountRequest

Messaggio di richiesta per il metodo UpdateAccount.

Campi
account

Account

Obbligatorio. La nuova versione dell'account.
update_mask

FieldMask

Facoltativo. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

Messaggio di richiesta per il metodo UpdateAutofeedSettings.

Campi
autofeed_settings

AutofeedSettings

Obbligatorio. La nuova versione dell'impostazione del feed automatico.
update_mask

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.

UpdateBusinessIdentityRequest

Messaggio di richiesta per il metodo UpdateBusinessIdentity.

Campi
business_identity

BusinessIdentity

Obbligatorio. La nuova versione dell'identità dell'attività.
update_mask

FieldMask

Facoltativo. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • black_owned
  • latino_owned
  • promotions_consent
  • small_business
  • veteran_owned
  • women_owned

UpdateBusinessInfoRequest

Messaggio di richiesta per il metodo UpdateBusinessInfo.

Campi
business_info

BusinessInfo

Obbligatorio. La nuova versione delle informazioni sull'attività.
update_mask

FieldMask

Facoltativo. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

UpdateEmailPreferencesRequest

Messaggio di richiesta per il metodo UpdateEmailPreferences.

Campi
email_preferences

EmailPreferences

Obbligatorio. Preferenze email da aggiornare.
update_mask

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

Messaggio di richiesta per il metodo UpdateHomepage.

Campi
homepage

Homepage

Obbligatorio. La nuova versione della home page.
update_mask

FieldMask

Facoltativo. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • uri

UpdateRegionRequest

Messaggio di richiesta per il metodo UpdateRegion.

Campi
region

Region

Obbligatorio. La regione aggiornata.
update_mask

FieldMask

Facoltativo. La maschera del campo separata da virgole che indica i campi da aggiornare. Esempio: "displayName,postalCodeArea.regionCode".

UpdateUserRequest

Messaggio di richiesta per il metodo UpdateUser.

Campi
user

User

Obbligatorio. La nuova versione dell'utente.

Utilizza me per fare riferimento al tuo indirizzo email, ad esempio accounts/{account}/users/me.
update_mask

FieldMask

Facoltativo. Elenco dei campi in fase di aggiornamento.

I seguenti campi sono supportati (sia in snake_case che in lowerCamelCase):

  • access_rights

Utente

Il messaggio User rappresenta un utente associato a un account Merchant Center. Viene utilizzato per gestire le autorizzazioni utente e i diritti di accesso all'interno dell'account. Per ulteriori informazioni, consulta le domande frequenti su persone e livelli di accesso.

Campi
name

string

Identificatore. Il nome della risorsa dell'utente. Formato: accounts/{account}/user/{email}

Utilizza me per fare riferimento al tuo indirizzo email, ad esempio accounts/{account}/users/me.
state

State

Solo output. Lo stato dell'utente.
access_rights[]

AccessRight

Facoltativo. I diritti di accesso di cui dispone l'utente.

Stato

I possibili stati di un utente.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
PENDING L'utente è in attesa di conferma. In questo stato, l'utente deve prima accettare l'invito prima di eseguire altre azioni.
VERIFIED L'utente è verificato.

Valore

Il singolo valore di un gruppo di tariffe o il valore della cella di una tabella di gruppi di tariffe. Deve essere impostato esattamente uno dei valori no_shipping, flat_rate, price_percentage, carrier_rateName, subtable_name.

Campi
no_shipping

bool

Se il valore è true, il prodotto non può essere spedito. Deve essere true se impostato, può essere impostato solo se tutti gli altri campi non sono impostati.
flat_rate

Price

Una tariffa fissa. Può essere impostato solo se non sono impostati tutti gli altri campi.
price_percentage

string

Una percentuale del prezzo rappresentata come numero in notazione decimale (ad es. "5.4"). Può essere impostato solo se non sono impostati tutti gli altri campi.
carrier_rate

string

Il nome di una tariffa del corriere che fa riferimento a una tariffa del corriere definita nello stesso gruppo di tariffe. Può essere impostato solo se non sono impostati tutti gli altri campi.
subtable

string

Il nome di una sottotabella. Può essere impostato solo nelle celle della tabella (ad esempio, non per i singoli valori) e solo se non sono impostati tutti gli altri campi.

Deposito

Un magazzino per l'evasione degli ordini, che gestisce e conserva l'inventario.

Campi
name

string

Obbligatorio. Il nome del magazzino. Deve essere univoco all'interno dell'account.
shipping_address

Address

Obbligatorio. Indirizzo di spedizione del magazzino.
cutoff_time

WarehouseCutoffTime

Obbligatorio. L'ora più tardi in cui un ordine può essere accettato e iniziare l'elaborazione. Gli ordini successivi verranno elaborati il giorno successivo. L'ora si basa sul codice postale del magazzino.
handling_days

int64

Obbligatorio. Il numero di giorni necessari a questo magazzino per imballare e spedire un articolo. Questo valore è a livello di magazzino, ma può essere ignorato a livello di offerta in base agli attributi di un articolo.
business_day_config

BusinessDayConfig

Giorni lavorativi del magazzino. Se non è impostato, per impostazione predefinita sarà dal lunedì al venerdì.

WarehouseBasedDeliveryTime

Indica che il tempo di consegna deve essere calcolato in base al magazzino (località di partenza della spedizione) in base alle impostazioni del corriere selezionato. Se impostato, non deve essere impostato nessun altro campo relativo al tempo di transito in delivery_time.

Campi
carrier

string

Obbligatorio. Operatore, ad esempio "UPS" o "Fedex". operatori supportati
carrier_service

string

Obbligatorio. Servizio dell'operatore, ad esempio "ground" o "2 days". Il nome del servizio deve essere presente nell'elenco eddSupportedServices.
warehouse

string

Obbligatorio. Nome del magazzino. Deve corrispondere a [warehouse][ShippingSetting.warehouses.name]

WarehouseCutoffTime

L'ora più tardi in cui è possibile accettare un ordine e iniziare l'elaborazione. Gli ordini successivi verranno elaborati il giorno successivo. L'ora si basa sul codice postale del magazzino.

Campi
hour

int32

Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. L'ora si basa sul fuso orario del magazzino.
minute

int32

Obbligatorio. Minuto dell'orario limite entro il quale deve essere effettuato un ordine affinché venga elaborato lo stesso giorno dal magazzino. Il minuto si basa sul fuso orario del magazzino.