Package google.shopping.merchant.accounts.v1beta

Indice

AccountIssueService

Servizio per supportare l'API AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Elenca tutti i problemi di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 si tratta solo di elencare i subaccount di un AMC, ma di tutti gli account a cui l'utente chiamante ha accesso, inclusi altri AMC, account collegati, account autonomi e così via. Se non viene fornito alcun filtro, vengono restituiti gli account a cui l'utente è aggiunto direttamente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
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 della chiamata a 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 panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.

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 panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.

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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.

BusinessInfoService

Servizio di supporto dell'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 Panoramica di OAuth 2.0.
UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Consente di aggiornare 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 Panoramica di OAuth 2.0.

EmailPreferencesService

Servizio per supportare l'API EmailPreferences.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Restituisce le preferenze email per l'utente di un 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 Panoramica di OAuth 2.0.
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 se gli aggiornamenti specificano un valore per lo stato di attivazione NON CONFERMATO.

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 Panoramica di OAuth 2.0.

HomepageService

Servizio per il supporto di 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; - il reclamo non è andato a buon fine (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 Panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.
UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Consente di aggiornare 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 Panoramica di OAuth 2.0.

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 una norma sui resi esistente.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

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

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Elenca tutte le norme sui resi esistenti.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.

ProgramsService

Servizio per la gestione del programma.

I programmi forniscono un meccanismo per aggiungere funzionalità agli account commerciante. Un tipico esempio è il programma Schede di prodotto senza costi, che consente di mostrare senza costi i prodotti del negozio di un commerciante 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)

Disattiva 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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.

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 Panoramica di OAuth 2.0.
DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Elimina 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 panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.

ShippingSettingsService

Servizio per ottenere informazioni sulle impostazioni di spedizione della chiamata di metodo in base al metodo 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 Panoramica di OAuth 2.0.
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 panoramica di OAuth 2.0.

TermsOfServiceAgreementStateService

Servizio per supportare l'API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Restituisce lo stato di un contratto relativo ai Termini di servizio.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.

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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.

UserService

Servizio per supportare l'API utente.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Crea un utente con 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 Panoramica di OAuth 2.0.
DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Elimina l'utente di un 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 panoramica di OAuth 2.0.
GetUser

rpc GetUser(GetUserRequest) returns (User)

Recupera l'utente di un account Merchant Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la Panoramica di OAuth 2.0.
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 Panoramica di OAuth 2.0.
UpdateUser

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 Panoramica di OAuth 2.0.

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 il quale accettare i TdS.
region_code

string

Obbligatorio. Codice regione come definito da CLDR. Si tratta di un paese in cui i TdS si applicano specificamente a quel paese oppure dell'001 quando i TdS sono applicabili 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, ne deve essere accettata una nuova. 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

Un account.

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, vedi il nome del negozio e il 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.

Payload AccountAggregation.

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 con 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 migliorare.

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, in genere i prodotti vengono visualizzati immediatamente. Quando la riattivi, 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à aziendale. 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 di 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 di marketplace.
veteran_owned

IdentityAttribute

(Facoltativo) Specifica se l'attività si identifica come di proprietà di un veterano. 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 di 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

Raccolta di informazioni relative a un'attività.

Campi
name

string

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

PostalAddress

(Facoltativo) L'indirizzo dell'attività.
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.

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. L'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 additivo. 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[]

CreateUserRequest

(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 aggiuntivi account_management o product_management.

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. Formato: accounts/{account}

CreateRegionRequest

Messaggio di richiesta per il metodo CreateRegion.

Campi
parent

string

Obbligatorio. L'account per il quale 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

Obbligatorio. 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'orario limite nei giorni lavorativi.

Campi
hour

int32

Obbligatorio. Ora dell'orario limite entro il quale deve essere effettuato un ordine per consentirne l'elaborazione 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 (luogo 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 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 significa la consegna in giornata, 1 significa la consegna il giorno successivo. Deve essere maggiore o uguale a min_transit_days.
cutoff_time

CutoffTime

Definizione dell'orario limite nei 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 devono essere impostati contemporaneamente.
max_handling_days

int32

Numero massimo di giorni lavorativi trascorsi prima della spedizione di un ordine. 0 significa che viene spedito lo stesso giorno, 1 significa che verrà spedito 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 specificato, vengono utilizzati i giorni lavorativi dal lunedì al 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 requisito è obbligatorio 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 in modo da 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. Nome 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 seguenti valori: prices, weights, num_items, postal_code_group_names o location.

Campi
prices[]

Price

Obbligatorio. Un elenco di limiti superiori dei prezzi degli ordini inclusivi. Il valore dell'ultimo prezzo può essere infinito impostando importo_micros del prezzo su -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 inclusivi del peso dell'ordine. 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 tutti gli altri campi non sono impostati.
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". Il campo non può 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 indicati devono corrispondere al paese di consegna del servizio. Il campo non può essere vuoto. Può essere impostato solo se tutti gli altri campi non sono impostati.
locations[]

LocationIdSet

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

Home page

La home page di un negozio.

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 dello store.

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 precedente chiamata a ListAccountIssues. 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 da una persona nella lingua specificata. Il formato è BCP-47, ad esempio en-US o sr-Latn. Se non viene fornito un 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 configurato, viene 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 un valore inferiore a 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.

Durante l'impaginazione, tutti gli altri parametri forniti a ListAccounts devono corrispondere alla chiamata che ha fornito il token della 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 valore 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 il quale elencare le regioni. Formato: accounts/{account}
page_size

int32

(Facoltativo) Il numero massimo di regioni da restituire. Il servizio potrebbe restituire un valore inferiore a 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. L'account principale. Formato: accounts/{account}
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 principale 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. L'entità principale, proprietaria 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 precedente chiamata a ListUsers. 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 località. 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 località. 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ò apparire 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 norma sui resi generato da Google.
label

string

Questo campo rappresenta l'etichetta univoca definita dall'utente della norma 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 di etichetta specifico, le norme verranno etichettate automaticamente come "predefinite". Per assegnare le norme sui resi personalizzate a determinati gruppi di prodotti, segui le istruzioni fornite nell'etichetta delle norme sui resi. L'etichetta può contenere fino a 50 caratteri.
countries[]

string

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

Policy

Le norme sui resi.
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 per il reso. Deve essere impostato solo quando il cliente deve scaricare e stampare l'etichetta di reso.
return_policy_uri

string

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 è facoltativo e specifica il numero di giorni necessari ai commercianti per elaborare i rimborsi.
accept_exchange

bool

Questo campo è obbligatorio e specifica se il commerciante consente ai clienti di scambiare prodotti.

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 Il ritorno sul tempo.

RestockingFee

La commissione di riassortimento. Può essere una tariffa fissa o 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 costo di spedizione effettivo è a carico del cliente.

Campi
type

Type

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 l'effettivo costo di spedizione per il reso.

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 tipico esempio è 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. Puoi scegliere un paese in cui il programma si applica specificamente a tale paese oppure 001, se il programma è applicabile 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". Gli altri applicable_shipping_labels non devono 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 del corriere a cui main_table o single_value può fare riferimento.
single_value

Value

Il valore del gruppo di tariffe (ad esempio, costo fisso 10 $). Può essere impostato solo se i criteri main_table e subtables non sono impostati.
main_table

Table

Una tabella che definisce il gruppo di tariffe, quando single_value non è abbastanza 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 saperne di più, vedi 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 località. 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 la 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 pari a 1 per le tabelle monodimensionali.

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 campo applicable_shipping_labels vuoto, che significa "tutto il resto". Gli altri applicable_shipping_labels non devono 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à impostata 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 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 requisito è obbligatorio 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'orario 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 più giorni se hanno un servizio di spedizione configurato per la consegna locale in n giorni. Ad esempio, se il servizio di spedizione definisce la consegna in giornata ed ha superato l'orario limite, l'impostazione di questo campo su true determina la restituzione di NO_DELIVERY_POST_CUTOFF per la tariffa del servizio di spedizione calcolata. 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 procedere nel seguente modo:

  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 vengono modificati 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 è abbastanza 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 è impostata, la tabella ha una sola dimensione.

TermsOfService

Un TermsOfService.

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 i TdS applicabili a livello globale, ci aspettiamo che venga indicato un paese specifico (deve essere il paese dell'attività 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 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. Affinché l'account continui ad avere un contratto valido, è necessario accettare i Termini di servizio di required prima del giorno valid_until. Quando accetti i nuovi Termini di servizio, ci aspettiamo che le terze parti mostrino il testo associato al contratto relativo ai Termini di servizio specificato (l'URL del file contenente il testo viene aggiunto nel messaggio obbligatorio riportato di seguito come tos_file_uri. L'accettazione effettiva dei Termini di servizio viene eseguita chiamando accept nella 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 associato 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 richiesti

TermsOfServiceKind

Il tipo TermsOfService.

Enum
TERMS_OF_SERVICE_KIND_UNSPECIFIED Valore predefinito. Questo valore non è utilizzato.
MERCHANT_CENTER l'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 indicati 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 postal_code_group_names o transit_time_labels, sono presenti più righe, ciascuna con un valore per quella 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 del 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 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 vuoi recedere dalla 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

Obbligatorio. Elenco dei campi in fase di aggiornamento.

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

Obbligatorio. Elenco dei campi in fase di aggiornamento.

UpdateBusinessInfoRequest

Messaggio di richiesta per il metodo UpdateBusinessInfo.

Campi
business_info

BusinessInfo

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

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.

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.

UpdateHomepageRequest

Messaggio di richiesta per il metodo UpdateHomepage.

Campi
homepage

Homepage

Obbligatorio. La nuova versione della home page.
update_mask

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.

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.

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

FieldMask

Obbligatorio. Elenco dei campi in fase di aggiornamento.

Utente

Un utente.

Campi
name

string

Identificatore. Il nome 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 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

Costo fisso. Può essere impostato solo se non sono impostati tutti gli altri campi.
price_percentage

string

Una percentuale del prezzo rappresentata come numero con notazione decimale (ad es. "5.4"). Può essere impostata solo se tutti gli altri campi non sono impostati.
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 di evasione degli ordini, che gestisce e conserva l'inventario. Tag successivo: 7

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 è possibile accettare un ordine e iniziare l'elaborazione. Gli ordini successivi verranno elaborati nel 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 (luogo 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".
carrier_service

string

Obbligatorio. Servizio del corriere, 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 fino al quale deve essere effettuato un ordine per essere elaborato nello 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.