Package google.shopping.merchant.accounts.v1beta

Index

AccountIssueService

Service compatible avec l'API AccountIssueService.

ListAccountIssues

rpc ListAccountIssues(ListAccountIssuesRequest) returns (ListAccountIssuesResponse)

Répertorie tous les problèmes liés à un compte Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

AccountTaxService

Gère les données sur les paramètres de taxes au niveau du compte.

Cette API définit le modèle de ressources suivant:

  • AccountTax
GetAccountTax

rpc GetAccountTax(GetAccountTaxRequest) returns (AccountTax)

Affiche les règles fiscales qui correspondent aux conditions de GetAccountTaxRequest

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListAccountTax

rpc ListAccountTax(ListAccountTaxRequest) returns (ListAccountTaxResponse)

Liste les paramètres de taxes des sous-comptes uniquement dans votre compte Merchant Center. Cette méthode ne peut être appelée que sur un multicompte. Dans le cas contraire, elle renvoie une erreur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateAccountTax

rpc UpdateAccountTax(UpdateAccountTaxRequest) returns (AccountTax)

Met à jour les paramètres de taxes du compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

AccountsService

Service compatible avec l'API Accounts.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Crée un compte Merchant Center autonome avec une configuration supplémentaire. Ajoute l'utilisateur qui effectue la demande en tant qu'administrateur du nouveau compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Supprime le compte spécifié quel que soit son type: compte individuel, MC ou sous-compte. La suppression d'un MC entraîne la suppression de tous ses sous-comptes. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Récupère un compte de votre compte Merchant Center. Une fois que vous avez inséré, mis à jour ou supprimé un compte, plusieurs minutes peuvent s'écouler avant que les modifications ne soient prises en compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Liste les comptes accessibles à l'utilisateur appelant et correspondant aux contraintes de la requête, telles que la taille de la page ou les filtres. Il ne s'agit pas seulement de lister les sous-comptes d'un MC, mais tous les comptes auxquels l'utilisateur appelant a accès, y compris d'autres multicomptes, des comptes associés, des comptes individuels, etc.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Permet de répertorier tous les sous-comptes d'un multicompte donné. Il s'agit d'un wrapper de commodité pour la méthode ListAccounts, plus puissante. Cette méthode produira les mêmes résultats que d'appeler ListsAccounts avec le filtre suivant: relationship(providerId={parent} AND service(type="ACCOUNT_AGGREGATION"))

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateAccount

rpc UpdateAccount(UpdateAccountRequest) returns (Account)

Met à jour un compte quel que soit son type: compte individuel, MC ou sous-compte. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

BusinessIdentityService

Service compatible avec l'API Business Identity.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Récupère l'identité d'entreprise d'un compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Met à jour l'identité d'entreprise d'un compte. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

BusinessInfoService

Service compatible avec l'API Business Info.

GetBusinessInfo

rpc GetBusinessInfo(GetBusinessInfoRequest) returns (BusinessInfo)

Récupère les informations sur l'entreprise d'un compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateBusinessInfo

rpc UpdateBusinessInfo(UpdateBusinessInfoRequest) returns (BusinessInfo)

Met à jour les informations sur l'établissement d'un compte. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

EmailPreferencesService

Service compatible avec l'API EmailPreferences.

Ce service permet uniquement de récupérer et de mettre à jour les préférences relatives aux e-mails de l'utilisateur authentifié.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Affiche les préférences relatives aux e-mails d'un utilisateur de compte Merchant Center.

Utilisez l'alias name=accounts/*/users/me/emailPreferences pour obtenir les préférences de l'utilisateur authentifié.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateEmailPreferences

rpc UpdateEmailPreferences(UpdateEmailPreferencesRequest) returns (EmailPreferences)

Met à jour les préférences relatives aux e-mails d'un utilisateur de compte Merchant Center. Les utilisateurs du MC doivent spécifier le MC plutôt que celui d'un sous-compte du MC.

Les préférences qui ne sont pas explicitement sélectionnées dans le masque de mise à jour ne sont pas mises à jour.

La spécification d'une valeur d'état d'activation "NON CONFIRMÉE" dans les mises à jour n'est pas valide.

Utilisez l'alias name=accounts/*/users/me/emailPreferences pour mettre à jour les préférences de l'utilisateur authentifié.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

HomepageService

Service permettant d'utiliser une API pour la page d'accueil d'un magasin.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

Revend la page d'accueil d'une boutique. L'exécution de cette méthode nécessite un accès administrateur.

Si la page d'accueil a déjà été revendiquée, une nouvelle vérification de la validation sera effectuée (sauf si le marchand est exempté de la revendication, ce qui dispense également la validation) et renvoie une réponse valide. Si la propriété ne peut plus être validée, une erreur s'affiche, mais la revendication ne sera pas effacée. En cas d'échec, le message d'erreur canonique suivant s'affiche: * PERMISSION_DENIED: l'utilisateur ne dispose pas des autorisations nécessaires pour ce compte Merchant Center ; * FAILED_PRECONDITION: - Le compte n'est pas un compte Merchant Center ; - Le compte Merchant Center n'a pas de page d'accueil ; - Échec de la revendication (dans ce cas, le message d'erreur contiendra plus de détails).

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetHomepage

rpc GetHomepage(GetHomepageRequest) returns (Homepage)

Récupère la page d'accueil d'un magasin.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Ne revendique pas la page d'accueil d'un magasin. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateHomepage

rpc UpdateHomepage(UpdateHomepageRequest) returns (Homepage)

Met à jour la page d'accueil d'un magasin. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

OnlineReturnPolicyService

Ce service facilite la gestion de la configuration des conditions de retour du marchand en cas de rétractation, en incluant les conditions de retour pour les annonces et les fiches sans frais.

programmes. Cette API définit le modèle de ressources suivant:

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Récupère les conditions de retour existantes.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Liste toutes les conditions de retour existantes.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ProgramsService

Service de gestion de programmes.

Ces programmes permettent d'ajouter des fonctionnalités aux comptes marchands. Le programme Fiches produit sans frais en est un exemple typique. Il permet aux produits d'un marchand d'apparaître sans frais sur Google.

Ce service propose des méthodes permettant de récupérer la participation d'un marchand à tous les programmes disponibles, ainsi que des méthodes permettant d'activer ou de désactiver explicitement sa participation à chaque programme.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Désactiver la participation au programme spécifié pour le compte. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Autoriser la participation du compte au programme spécifié. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetProgram

rpc GetProgram(GetProgramRequest) returns (Program)

Récupère le programme spécifié pour le compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListPrograms

rpc ListPrograms(ListProgramsRequest) returns (ListProgramsResponse)

Récupère tous les programmes du compte.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

RegionsService

Gère la configuration des régions.

Cette API définit le modèle de ressources suivant:

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Crée une région dans votre compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

DeleteRegion

rpc DeleteRegion(DeleteRegionRequest) returns (Empty)

Supprime une définition de région de votre compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetRegion

rpc GetRegion(GetRegionRequest) returns (Region)

Récupère une région définie dans votre compte Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Liste les régions dans votre compte Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateRegion

rpc UpdateRegion(UpdateRegionRequest) returns (Region)

Met à jour la définition d'une région dans votre compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ShippingSettingsService

Service permettant d'obtenir des informations sur les paramètres de livraison des appels de méthode par méthode API Merchant Center.

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Récupérez les informations sur les paramètres de livraison.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Remplacez le paramètre de livraison d'un marchand par celui de la demande. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

TermsOfServiceAgreementStateService

Service compatible avec l'API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Affiche l'état d'un accord sur les conditions d'utilisation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

RetrieveForApplicationTermsOfServiceAgreementState

rpc RetrieveForApplicationTermsOfServiceAgreementState(RetrieveForApplicationTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Récupère l'état de l'accord pour les conditions d'utilisation de l'application.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

TermsOfServiceService

Service compatible avec l'API TermsOfService.

AcceptTermsOfService

rpc AcceptTermsOfService(AcceptTermsOfServiceRequest) returns (Empty)

Accepte un TermsOfService. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetTermsOfService

rpc GetTermsOfService(GetTermsOfServiceRequest) returns (TermsOfService)

Récupère l'TermsOfService associé à la version fournie.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

Récupère la dernière version de TermsOfService pour une kind et une region_code données.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UserService

Service permettant d'assurer la compatibilité avec l'API utilisateur.

CreateUser

rpc CreateUser(CreateUserRequest) returns (User)

Crée un utilisateur de compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Supprime un utilisateur de compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

GetUser

rpc GetUser(GetUserRequest) returns (User)

Récupère un utilisateur d'un compte Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

ListUsers

rpc ListUsers(ListUsersRequest) returns (ListUsersResponse)

Répertorie tous les utilisateurs d'un compte Merchant Center.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Met à jour un utilisateur de compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la Présentation d'OAuth 2.0.

AcceptTermsOfServiceRequest

Message de requête pour la méthode AcceptTermsOfService.

Champs
name

string

Obligatoire. Nom de ressource de la version des conditions d'utilisation. Format : termsOfService/{version}

account

string

Obligatoire. Compte pour lequel vous devez accepter les conditions d'utilisation.

region_code

string

Obligatoire. Code de région tel que défini par le CLDR. Il peut s'agir d'un pays dans lequel les conditions d'utilisation s'appliquent spécifiquement ou du nombre 001 lorsqu'elles s'appliquent à l'échelle mondiale.

Acceptée

Décrit les conditions d'utilisation acceptées.

Champs
terms_of_service

string

termsOfService.

accepted_by

string

Compte dans lequel l'acceptation a été enregistrée. Il peut s'agir du compte lui-même ou, dans le cas de sous-comptes, du MC.

valid_until

Date

Lorsqu'elle est définie, elle indique que les TermsOfService acceptées ne sont valides que jusqu'à la fin de cette date (indiquée en temps UTC). Vous devrez en accepter un nouveau avant cette date. Les informations sur les conditions d'utilisation TermsOfService obligatoires se trouvent dans le message Required.

AccessRight

Le droit d'accès.

Enums
ACCESS_RIGHT_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
STANDARD Droits d'accès standards.
ADMIN Droits d'accès administrateur.
PERFORMANCE_REPORTING Les utilisateurs disposant de ce droit ont accès aux performances et aux insights.

Compte

Un compte.

Champs
name

string

Identifiant. Nom de ressource du compte. Format : accounts/{account}

account_id

int64

Uniquement en sortie. Numéro du compte.

account_name

string

Obligatoire. Nom lisible du compte. Pour en savoir plus, consultez les articles sur le nom du magasin et le nom de l'entreprise.

adult_content

bool

Indique si ce compte inclut du contenu réservé aux adultes.

test_account

bool

Uniquement en sortie. S'il s'agit d'un compte de test.

time_zone

TimeZone

Obligatoire. Fuseau horaire du compte

En écriture, time_zone définit à la fois reporting_time_zone et display_time_zone.

Pour les lectures, time_zone renvoie toujours display_time_zone. Si display_time_zone n'existe pas pour votre compte, time_zone est vide.

language_code

string

Obligatoire. Le code de langue BCP-47 du compte (en-US ou sr-Latn, par exemple).

AccountIssue

Un AccountIssue.

Champs
name

string

Identifiant. Nom de ressource du problème lié au compte. Format : accounts/{account}/issues/{id}

title

string

Titre localisé du numéro.

severity

Severity

Gravité globale du problème

impacted_destinations[]

ImpactedDestination

L'impact de ce problème sur différentes destinations.

detail

string

Plus d'informations localisées sur le problème.

documentation_uri

string

Lien vers le centre d'aide Merchant Center fournissant des informations supplémentaires sur le problème et sa résolution.

ImpactedDestination

L'impact du problème sur une destination.

Champs
impacts[]

Impact

L'impact (négatif) pour différentes régions sur la destination donnée.

reporting_context

ReportingContextEnum

Contexte de reporting affecté

Impact

L'impact du problème sur une région.

Champs
region_code

string

Code CLDR dans lequel ce problème s'applique.

severity

Severity

Gravité du problème au niveau de la destination et de la région

Gravité

Tous les niveaux de gravité possibles.

Enums
SEVERITY_UNSPECIFIED La gravité est inconnue.
CRITICAL Ce problème empêche la diffusion des offres.
ERROR Le problème peut avoir une incidence sur les offres (à l'avenir) ou indiquer des problèmes liés aux offres.
SUGGESTION Le problème est une suggestion d'amélioration.

AccountTax

Paramètres de taxes d'un compte marchand. Toutes les méthodes nécessitent le rôle d'administrateur.

Champs
name

string

Identifiant. Nom du paramètre de taxe. Format: "{account_tax.name=accounts/{account}}"

account

int64

Uniquement en sortie. Numéro du compte auquel appartiennent ces paramètres de taxes.

tax_rules[]

TaxRule

Règles fiscales "Définissez les règles fiscales dans chaque région. Aucune taxe ne sera présentée si une région n'a pas de règle."

Adresse

Adresse de livraison de l'entrepôt.

Champs
street_address

string

Partie de l'adresse située au niveau de la rue. Exemple : 111w 31st Street.

city

string

Obligatoire. Ville ou commune. Peut également inclure des localités ou sous-localités dépendantes (par exemple, des quartiers ou des banlieues).

administrative_area

string

Obligatoire. Subdivision administrative de niveau supérieur du pays. Par exemple, un État comme la Californie ("CA") ou une province comme le Québec ("QC").

postal_code

string

Obligatoire. Code postal (par exemple, "94043").

region_code

string

Obligatoire. Code pays CLDR (par exemple, "US").

BusinessDayConfig

Jours ouvrés de l'entrepôt.

Champs
business_days[]

Weekday

Obligatoire. Jours ouvrés normaux. Ne peut pas être vide.

Jour de la semaine

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Collecte d'informations en lien avec l'identité d'une entreprise.

Champs
name

string

Identifiant. Nom de ressource de l'identité de l'entreprise. Format : accounts/{account}/businessIdentity

black_owned

IdentityAttribute

Facultatif. Indique si l'établissement s'identifie comme détenu par un noir. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Elle ne s'applique pas non plus aux places de marché ni aux vendeurs sur les places de marché.

women_owned

IdentityAttribute

Facultatif. Indique si l'établissement est détenu par une femme. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Elle ne s'applique pas non plus aux places de marché ni aux vendeurs sur les places de marché.

veteran_owned

IdentityAttribute

Facultatif. Indique si l'établissement est détenu par un vétéran. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Elle ne s'applique pas non plus aux places de marché ni aux vendeurs sur les places de marché.

latino_owned

IdentityAttribute

Facultatif. Indique si l'établissement s'identifie comme détenu par un groupe latino-américain. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Elle ne s'applique pas non plus aux places de marché ni aux vendeurs sur les places de marché.

small_business

IdentityAttribute

Facultatif. Indique si l'établissement s'identifie comme une petite entreprise. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Elle ne s'applique pas non plus aux places de marché.

IdentityAttribute

Toutes les informations liées à un attribut d'identité.

Champs
identity_declaration

IdentityDeclaration

Obligatoire. Déclaration d'identité pour cet attribut.

IdentityDeclaration

Tous les paramètres possibles concernant la déclaration d'identité.

Enums
IDENTITY_DECLARATION_UNSPECIFIED Valeur par défaut indiquant qu'aucune sélection n'a été effectuée.
SELF_IDENTIFIES_AS Indique que le compte s'identifie à l'attribut.
DOES_NOT_SELF_IDENTIFY_AS Indique que le compte ne s'identifie pas à l'attribut.

PromotionsConsent

Tous les paramètres possibles concernant les promotions liées à l'identité de l'entreprise.

Enums

BusinessInfo

Collecte d'informations sur une entreprise.

Champs
name

string

Identifiant. Nom de ressource des informations sur l'établissement. Format: accounts/{account}/businessInfo

address

PostalAddress

Facultatif. Adresse de l'établissement.

phone

PhoneNumber

Uniquement en sortie. Numéro de téléphone de l'établissement.

phone_verification_state

PhoneVerificationState

Uniquement en sortie. État de validation du numéro de téléphone de l'établissement.

customer_service

CustomerService

Facultatif. Le service client de l'établissement.

CarrierRate

Liste des tarifs de transporteurs auxquels les main_table ou single_value peuvent faire référence.

Champs
name

string

Obligatoire. Nom du tarif du transporteur. Doit être unique pour chaque groupe de tarifs.

carrier

string

Obligatoire. Service de transporteur, tel que "UPS" ou "Fedex".

carrier_service

string

Obligatoire. Service de transporteur, tel que "ground" ou "2 days".

origin_postal_code

string

Obligatoire. Lieu de livraison pour ce tarif de transporteur.

percentage_adjustment

string

Facultatif. Multiplicateur du modificateur des frais de port sous forme de nombre en notation décimale. Peut être négatif. Par exemple, "5.4" augmente le tarif de 5,4%, "-3" le réduit de 3%.

flat_adjustment

Price

Facultatif. Modificateur de frais de port supplémentaire. Peut être négatif. Par exemple, { "amount_micros": 1, "currency_code" : "USD" } ajoute 1 € au tarif et { "amount_micros": -3, "currency_code" : "USD" } en supprime 3 €.

ClaimHomepageRequest

Message de requête pour la méthode ClaimHomepage.

Champs
name

string

Obligatoire. Nom de la page d'accueil à revendiquer. Format : accounts/{account}/homepage

CreateAndConfigureAccountRequest

Message de requête pour la méthode CreateAndConfigureAccount.

Champs
account

Account

Obligatoire. Compte à créer.

users[]

CreateUserRequest

Facultatif. Utilisateurs à ajouter au compte.

service[]

AddAccountService

Facultatif. Si spécifié, un service de compte entre le compte à créer et le compte du fournisseur est initialisé lors de la création.

accept_terms_of_service

AcceptTermsOfService

Facultatif. Les conditions d'utilisation doivent être acceptées dès la création d'un compte.

AcceptTermsOfService

Référence à une ressource de conditions d'utilisation.

Champs
name

string

Obligatoire. Nom de ressource de la version des conditions d'utilisation.

region_code

string

Obligatoire. Code de région tel que défini par le CLDR. Il peut s'agir d'un pays où les conditions d'utilisation s'appliquent spécifiquement ou de 001 lorsqu'elles s'appliquent à l'échelle mondiale.

AddAccountService

Instructions supplémentaires pour ajouter des services lors de la création du compte

Champs
Champ d'union service_type. Actuellement, seul le type de compte parent multiclient est accepté. La service_type ne peut être qu'un des éléments suivants :
account_aggregation

Empty

Le fournisseur est un agrégateur pour le compte.

provider

string

Facultatif. Fournisseur du service. Format : accounts/{account}

CreateRegionRequest

Message de requête pour la méthode CreateRegion.

Champs
parent

string

Obligatoire. Compte pour lequel créer une région. Format : accounts/{account}

region_id

string

Obligatoire. Identifiant de la région, unique dans toutes les régions d'un même compte.

region

Region

Obligatoire. Région à créer.

CreateUserRequest

Message de requête pour la méthode CreateUser.

Champs
parent

string

Obligatoire. Nom de ressource du compte pour lequel un utilisateur sera créé. Format : accounts/{account}

user_id

string

Obligatoire. Adresse e-mail de l'utilisateur (par exemple, john.doe@gmail.com).

user

User

Obligatoire. Utilisateur à créer.

CustomerService

Informations sur le service client

Champs
uri

string

Facultatif. URI où se trouve le service client.

email

string

Facultatif. Adresse e-mail à laquelle le service client peut être contacté.

phone

PhoneNumber

Facultatif. Numéro de téléphone auquel le service client peut être appelé.

CutoffTime

Définition de l'heure limite pour les jours ouvrés.

Champs
hour

int32

Obligatoire. Heure de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même.

minute

int32

Obligatoire. Minute de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même.

time_zone

string

Obligatoire. Identifiant de fuseau horaire : par exemple, "Europe/Zurich".

DeleteAccountRequest

Message de requête pour la méthode DeleteAccount.

Champs
name

string

Obligatoire. Nom du compte à supprimer. Format : accounts/{account}

DeleteRegionRequest

Message de requête pour la méthode DeleteRegion.

Champs
name

string

Obligatoire. Nom de la région à supprimer. Format : accounts/{account}/regions/{region}

DeleteUserRequest

Message de requête pour la méthode DeleteUser.

Champs
name

string

Obligatoire. Nom de l'utilisateur à supprimer. Format : accounts/{account}/users/{email}

Il est également possible de supprimer l'utilisateur correspondant à l'appelant en utilisant me au lieu d'une adresse e-mail, comme dans accounts/{account}/users/me.

DeliveryTime

Temps consacré à divers aspects, de la commande à la livraison du produit.

Champs
warehouse_based_delivery_times[]

WarehouseBasedDeliveryTime

Facultatif. Indique que le délai de livraison doit être calculé pour chaque entrepôt (adresse d'origine de l'expédition) en fonction des paramètres du transporteur sélectionné. Lorsque cette option est définie, aucun autre champ lié au délai d'acheminement dans [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] ne doit être défini.

min_transit_days

int32

Nombre minimal de jours ouvrés passés en acheminement. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain. Vous devez définir min_transit_days, max_transit_days ou transit_time_table, mais pas les deux.

max_transit_days

int32

Nombre maximal de jours ouvrés passés en acheminement. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain. La valeur doit être supérieure ou égale à min_transit_days.

cutoff_time

CutoffTime

Définition de l'heure limite pour les jours ouvrés. Si elle n'est pas configurée, l'heure limite sera définie par défaut sur 8h PST.

min_handling_days

int32

Nombre minimal de jours ouvrés dépensés avant l'expédition d'une commande. La valeur 0 correspond à la livraison le jour même, et la valeur 1 à la livraison le lendemain.

max_handling_days

int32

Nombre maximal de jours ouvrés dépensés avant l'expédition d'une commande. La valeur 0 correspond à la livraison le jour même, et la valeur 1 à la livraison le lendemain. La valeur doit être supérieure ou égale à min_handling_days.

transit_time_table

TransitTable

Tableau du délai d'acheminement, nombre de jours ouvrés passés en transit en fonction des dimensions des lignes et des colonnes. Vous pouvez définir min_transit_days, max_transit_days ou transit_time_table, mais pas les deux.

handling_business_day_config

BusinessDayConfig

Jours ouvrés pendant lesquels les commandes peuvent être traitées. Si aucune valeur n'est fournie, le système considère que les jours ouvrés sont du lundi au vendredi.

transit_business_day_config

BusinessDayConfig

Jours ouvrés pendant lesquels les commandes peuvent être en transit. Si aucune valeur n'est fournie, le système considère que les jours ouvrés sont du lundi au vendredi.

DisableProgramRequest

Message de requête pour la méthode DisableProgram.

Champs
name

string

Obligatoire. Nom du programme auquel le compte donné doit désactiver la participation. Format : accounts/{account}/programs/{program}

Distance

Rayon de livraison maximal Cette valeur n'est obligatoire que pour le type de livraison en magasin.

Champs
value

int64

Distance (nombre entier).

unit

Unit

L'unité peut varier en fonction du pays. Elle est paramétrée pour inclure les miles et les kilomètres.

Unité

L'unité peut varier en fonction du pays. Elle est paramétrée pour inclure les miles et les kilomètres.

Enums
UNIT_UNSPECIFIED Unité non spécifiée
MILES Unité en miles
KILOMETERS Unité en kilomètres

EmailPreferences

Catégories de notifications activées / désactivées par l'utilisateur. Les préférences relatives aux e-mails n'incluent pas les annonces obligatoires, car les utilisateurs ne peuvent pas les désactiver.

Champs
name

string

Identifiant. Nom de la ressource EmailPreferences. Le point de terminaison n'est compatible qu'avec l'utilisateur authentifié.

news_and_tips

OptInState

Facultatif. Informations sur les nouvelles fonctionnalités, conseils et bonnes pratiques.

OptInState

Activer l'état des préférences relatives aux e-mails.

Enums
OPT_IN_STATE_UNSPECIFIED L'état d'activation n'est pas spécifié.
OPTED_OUT L'utilisateur a désactivé la réception de ce type d'e-mail.
OPTED_IN L'utilisateur a accepté de recevoir ce type d'e-mail.
UNCONFIRMED L'utilisateur a accepté de recevoir ce type d'e-mail et l'e-mail de confirmation a été envoyé, mais il n'a pas encore confirmé l'activation (s'applique uniquement à certains pays).

EnableProgramRequest

Message de requête pour la méthode EnableProgram.

Champs
name

string

Obligatoire. Nom du programme auquel le compte donné doit autoriser la participation. Format : accounts/{account}/programs/{program}

GetAccountRequest

Message de requête pour la méthode GetAccount.

Champs
name

string

Obligatoire. Nom du compte à récupérer. Format : accounts/{account}

GetAccountTaxRequest

Demander l'obtention des paramètres de taxes

Champs
name

string

Obligatoire. Nom à partir duquel les paramètres de taxes seront récupérés

GetBusinessIdentityRequest

Message de requête pour la méthode GetBusinessIdentity.

Champs
name

string

Obligatoire. Nom de ressource de l'identité de l'entreprise. Format : accounts/{account}/businessIdentity

GetBusinessInfoRequest

Message de requête pour la méthode GetBusinessInfo.

Champs
name

string

Obligatoire. Nom de ressource des informations sur l'établissement. Format: accounts/{account}/businessInfo

GetEmailPreferencesRequest

Message de requête pour la méthode GetEmailPreferences.

Champs
name

string

Obligatoire. Nom de la ressource EmailPreferences. Format : accounts/{account}/users/{email}/emailPreferences

GetHomepageRequest

Message de requête pour la méthode GetHomepage.

Champs
name

string

Obligatoire. Nom de la page d'accueil à récupérer. Format : accounts/{account}/homepage

GetOnlineReturnPolicyRequest

Message de requête pour la méthode GetOnlineReturnPolicy.

Champs
name

string

Obligatoire. Nom des conditions de retour à récupérer. Format : accounts/{account}/onlineReturnPolicies/{return_policy}

GetProgramRequest

Message de requête pour la méthode GetProgram.

Champs
name

string

Obligatoire. Nom du programme à récupérer. Format : accounts/{account}/programs/{program}

GetRegionRequest

Message de requête pour la méthode GetRegion.

Champs
name

string

Obligatoire. Nom de la région à récupérer. Format : accounts/{account}/regions/{region}

GetShippingSettingsRequest

Message de requête pour la méthode GetShippingSetting.

Champs
name

string

Obligatoire. Nom du paramètre de livraison à récupérer. Format : accounts/{account}/shippingsetting

GetTermsOfServiceAgreementStateRequest

Message de requête pour la méthode GetTermsOfServiceAgreementState.

Champs
name

string

Obligatoire. Nom de ressource de la version des conditions d'utilisation. Format: accounts/{account}/termsOfServiceAgreementState/{identifier}. Le format de l'identifiant est le suivant: {TermsOfServiceKind}-{country}.

GetTermsOfServiceRequest

Message de requête pour la méthode GetTermsOfService.

Champs
name

string

Obligatoire. Nom de ressource de la version des conditions d'utilisation. Format : termsOfService/{version}

GetUserRequest

Message de requête pour la méthode GetUser.

Champs
name

string

Obligatoire. Nom de l'utilisateur à récupérer. Format : accounts/{account}/users/{email}

Il est également possible de récupérer l'utilisateur correspondant à l'appelant en utilisant me plutôt qu'une adresse e-mail, comme dans accounts/{account}/users/me.

En-têtes

Liste non vide d'en-têtes de ligne ou de colonne pour un tableau. Vous ne devez définir qu'une seule des propriétés suivantes : prices, weights, num_items, postal_code_group_names ou location.

Champs
prices[]

Price

Obligatoire. Liste de limites supérieures de prix de commande inclus. La valeur du dernier prix peut être infinie en définissant "price amount_micros" sur -1. Par exemple, [{"amount_micros": 10000000, "currency_code": "USD"}, {"amount_micros": 500000000, "currency_code": "USD"}, {"amount_micros": -1, "currency_code": "USD"}] représente les en-têtes "<= $10", "<= $500" et "> $500". Tous les prix d'un service doivent être exprimés dans la même devise. Ce champ ne doit pas être vide. Doit être positif, sauf -1. Ne peut être défini que si aucun autre champ n'est défini.

weights[]

Weight

Obligatoire. Liste de limites supérieures inclusives de poids de commande. La dernière valeur de pondération peut être infinie si vous définissez "price amount_micros" sur -1. Par exemple, [{"amount_micros": 10000000, "unit": "kg"}, {"amount_micros": 50000000, "unit": "kg"}, {"amount_micros": -1, "unit": "kg"}] représente les en-têtes "<= 10 kg", "<= 50 kg" et "> 50 kg". Toutes les pondérations d'un service doivent avoir la même unité. Ce champ ne doit pas être vide. Doit être positif, sauf -1. Ne peut être défini que si aucun autre champ n'est défini.

number_of_items[]

string

Obligatoire. Liste de limites supérieures (nombre inclusif) d'éléments. La dernière valeur peut être "infinity". Par exemple, ["10", "50", "infinity"] représente les en-têtes "<= 10 articles", "<= 50 articles" et "> 50 articles". Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

postal_code_group_names[]

string

Obligatoire. Liste de noms de groupes postaux. La dernière valeur peut être "all other locations". Exemple : ["zone 1", "zone 2", "all other locations"]. Les groupes de codes postaux mentionnés doivent correspondre au pays de livraison du service. Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

locations[]

LocationIdSet

Obligatoire. Liste des ensembles d'ID de zones géographiques. Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

Page d'accueil

Page d'accueil d'un magasin

Champs
name

string

Identifiant. Nom de ressource de la page d'accueil du magasin. Format : accounts/{account}/homepage

claimed

bool

Uniquement en sortie. Indique si la page d'accueil est revendiquée. Consultez la page https://support.google.com/merchants/answer/176793.

uri

string

Obligatoire. URI (généralement une URL) de la page d'accueil du magasin.

InsertShippingSettingsRequest

Message de requête pour la méthode InsertShippingSetting.

Champs
parent

string

Obligatoire. Compte dans lequel ce produit sera inséré. Format: accounts/{account}

shipping_setting

ShippingSettings

Obligatoire. Nouvelle version du compte.

ListAccountIssuesRequest

Message de requête pour la méthode ListAccountIssues.

Champs
parent

string

Obligatoire. Le parent, qui possède cet ensemble de numéros. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de numéros à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 utilisateurs au maximum seront renvoyés. La valeur maximale est 100. Les valeurs supérieures à 100 sont forcées à 100.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListAccountIssues précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListAccountIssues doivent correspondre à l'appel ayant fourni le jeton de page.

language_code

string

Facultatif. Les problèmes dans la réponse comporteront des champs lisibles par l'humain dans la langue donnée. Le format est BCP-47 (en-US ou sr-Latn, par exemple). Si aucune valeur n'est fournie, en-US est utilisé.

time_zone

TimeZone

Facultatif. Fuseau horaire IANA utilisé pour localiser les heures dans des champs lisibles. Par exemple, "America/Los_Angeles". Si cette règle n'est pas configurée, "America/Los_Angeles" est utilisé.

ListAccountIssuesResponse

Message de réponse pour la méthode ListAccountIssues.

Champs
account_issues[]

AccountIssue

Problèmes du compte spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListAccountTaxRequest

Demande de lister tous les paramètres de taxes du sous-compte uniquement pour le marchand à l'origine de la demande. Cette méthode ne peut être appelée que sur un multicompte. Dans le cas contraire, elle renvoie une erreur.

Champs
parent

string

Obligatoire. Le parent, qui est responsable de la collecte des taxes sur le compte. Format: accounts/{account}

page_size

int32

Nombre maximal de paramètres de taxes à renvoyer dans la réponse. Utilisé pour la pagination.

page_token

string

Jeton renvoyé par la requête précédente.

ListAccountTaxResponse

Réponse à la demande de liste des taxes du compte. Cette méthode ne peut être appelée que sur un multicompte. Dans le cas contraire, elle renverra une erreur.

Champs
account_taxes[]

AccountTax

Page des paramètres de accounttax

next_page_token

string

Jeton permettant de récupérer la page suivante des paramètres de taxes du compte.

ListAccountsRequest

Message de requête pour la méthode ListAccounts.

Champs
page_size

int32

Facultatif. Nombre maximal de comptes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 250 comptes au maximum sont renvoyés. La valeur maximale est 500. Les valeurs supérieures à 500 sont forcées à 500.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListAccounts précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListAccounts doivent correspondre à l'appel ayant fourni le jeton de page.

filter

string

Facultatif. Affiche uniquement les comptes correspondant au filtre. Pour en savoir plus, consultez la documentation de référence sur la syntaxe des filtres.

ListAccountsResponse

Message de réponse pour la méthode ListAccounts.

Champs
accounts[]

Account

Les comptes correspondant à l'ListAccountsRequest.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListOnlineReturnPoliciesRequest

Message de requête pour la méthode ListOnlineReturnPolicies.

Champs
parent

string

Obligatoire. Compte marchand pour lequel vous souhaitez lister les conditions de retour. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de ressources OnlineReturnPolicy à renvoyer. Le service renvoie un nombre inférieur à cette valeur si le nombre de conditions de retour disponibles pour le marchand donné est inférieur à pageSize. La valeur par défaut est 10. La valeur maximale est 100. Si une valeur supérieure au maximum est spécifiée, pageSize est défini sur la valeur maximale par défaut.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListOnlineReturnPolicies précédent. Indiquez le jeton de page pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListOnlineReturnPolicies doivent correspondre à l'appel ayant fourni le jeton de page. Le jeton a été renvoyé en tant que nextPageToken dans la réponse à la requête précédente.

ListOnlineReturnPoliciesResponse

Message de réponse pour la méthode ListOnlineReturnPolicies.

Champs
online_return_policies[]

OnlineReturnPolicy

Conditions de retour récupérées.

next_page_token

string

Jeton pouvant être envoyé en tant que pageToken pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListProgramsRequest

Message de requête pour la méthode ListPrograms.

Champs
parent

string

Obligatoire. Nom du compte pour lequel vous souhaitez récupérer tous les programmes. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de programmes à renvoyer en une seule réponse. Si aucune valeur n'est spécifiée (ou 0), la taille par défaut utilisée est de 1 000. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de continuité, reçu d'un appel ListPrograms précédent. Fournissez-le pour récupérer la page suivante.

ListProgramsResponse

Message de réponse pour la méthode ListPrograms.

Champs
programs[]

Program

Programmes pour le compte donné.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListRegionsRequest

Message de requête pour la méthode ListRegions.

Champs
parent

string

Obligatoire. Compte pour lequel répertorier les régions. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de régions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 régions au maximum seront renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListRegions précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListRegions doivent correspondre à l'appel ayant fourni le jeton de page.

ListRegionsResponse

Message de réponse pour la méthode ListRegions.

Champs
regions[]

Region

Régions du marchand spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListSubAccountsRequest

Message de requête pour la méthode ListSubAccounts.

Champs
provider

string

Obligatoire. Le compte parent Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de comptes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 250 comptes au maximum sont renvoyés. La valeur maximale est 500. Les valeurs supérieures à 500 sont forcées à 500.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListAccounts précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListAccounts doivent correspondre à l'appel ayant fourni le jeton de page.

ListSubAccountsResponse

Message de réponse pour la méthode ListSubAccounts.

Champs
accounts[]

Account

Comptes pour lesquels le compte parent donné est un agrégateur.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

ListUsersRequest

Message de requête pour la méthode ListUsers.

Champs
parent

string

Obligatoire. Le parent, qui possède cette collection d'utilisateurs. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal d'utilisateurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 utilisateurs au maximum seront renvoyés. La valeur maximale est 100. Les valeurs supérieures à 100 sont forcées à 100.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListUsers précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, tous les autres paramètres fournis à ListUsers doivent correspondre à l'appel ayant fourni le jeton de page.

ListUsersResponse

Message de réponse pour la méthode ListUsers.

Champs
users[]

User

Utilisateurs du compte spécifié.

next_page_token

string

Jeton pouvant être envoyé en tant que page_token pour récupérer la page suivante. Si ce champ est omis, il n'y a pas d'autres pages.

LocationIdSet

Liste des ensembles d'ID de zones géographiques. Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

Champs
location_ids[]

string

Obligatoire. Liste non vide d'ID de zone géographique. Ils doivent tous être du même type d'emplacement (par exemple, un État).

MinimumOrderValueTable

Tableau des valeurs minimales de commande par magasin pour le type de retrait en magasin.

Champs
store_code_set_with_movs[]

StoreCodeSetWithMov

Obligatoire. Liste d'ensembles de codes de magasin partageant le même montant minimal de commande. Il doit y avoir au moins deux ensembles et le dernier vide, ce qui signifie "MOV for all other stores". Chaque code de magasin ne peut apparaître qu'une seule fois dans tous les ensembles. Tous les prix d'un service doivent être exprimés dans la même devise.

StoreCodeSetWithMov

Liste d'ensembles de codes de magasin partageant le même montant minimal de commande. Il doit y avoir au moins deux ensembles et le dernier vide, ce qui signifie "MOV for all other stores". Chaque code de magasin ne peut apparaître qu'une seule fois dans tous les ensembles. Tous les prix d'un service doivent être exprimés dans la même devise.

Champs
store_codes[]

string

Facultatif. Liste de codes de magasin uniques ou vide pour l'alias collecteur.

value

Price

Montant minimal de commande des magasins donnés.

OnlineReturnPolicy

Objet Conditions de retour en ligne. Il sert actuellement à représenter les conditions de retour pour les programmes des annonces et des fiches sans frais.

Champs
name

string

Identifiant. Nom de la ressource OnlineReturnPolicy. Format : accounts/{account}/onlineReturnPolicies/{return_policy}

return_policy_id

string

Uniquement en sortie. ID des conditions de retour généré par Google.

label

string

Ce champ représente le libellé unique des conditions de retour défini par l'utilisateur. Il est important de noter que vous ne pouvez pas utiliser la même étiquette dans des conditions de retour différentes pour un même pays. Les règles porteront automatiquement le libellé "par défaut", sauf si un produit spécifie un attribut d'étiquette spécifique. Pour attribuer des conditions de retour personnalisées à certains groupes de produits, suivez les instructions fournies dans le libellé des conditions de retour. Le libellé peut contenir jusqu'à 50 caractères.

countries[]

string

Pays de vente dans lesquels les conditions de retour s'appliquent. Les valeurs doivent être un code ISO 3166 à deux lettres valide.

policy

Policy

Conditions de retour.

restocking_fee

RestockingFee

Frais de remise en stock qui s'appliquent à toutes les catégories de motifs de retour. Ces frais sont alors considérés comme des frais de remise en stock sans frais si cette valeur n'est pas définie.

return_methods[]

ReturnMethod

Méthodes de retour utilisées par les clients pour retourner un article. Cette valeur ne doit pas être vide, sauf si le type de conditions de retour est "noReturns".

item_conditions[]

ItemCondition

Les conditions de retour acceptées pour les articles ne doivent pas être vides, sauf si le type de conditions de retour est défini sur "noReturns".

return_shipping_fee

ReturnShippingFee

Frais de port de retour. Ne doit être défini que lorsque le client doit télécharger et imprimer l'étiquette de retour.

return_policy_uri

string

URI des conditions de retour. Google peut l'utiliser pour effectuer un contrôle de l'intégrité de la règle. L'URL doit être valide.

accept_defective_only

bool

Ce champ est obligatoire et permet d'indiquer si le marchand n'accepte que les produits défectueux pour les retours.

process_refund_days

int32

Ce champ est facultatif et permet d'indiquer le nombre de jours nécessaires au traitement des remboursements par les marchands.

accept_exchange

bool

Ce champ est obligatoire et permet d'indiquer si le marchand autorise les clients à échanger des produits.

ItemCondition

Conditions de l'article disponible.

Enums
ITEM_CONDITION_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
NEW Des nouveautés
USED Utilisé.

Règlement

Règles disponibles.

Champs
type

Type

Type de règle.

days

int64

Nombre de jours pendant lesquels les articles peuvent être retournés après leur livraison (un jour correspond à 24 heures après le code temporel de livraison). Obligatoire pour les retours NUMBER_OF_DAYS_AFTER_DELIVERY.

Type

Types de conditions de retour.

Enums
TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
NUMBER_OF_DAYS_AFTER_DELIVERY Nombre de jours pendant lesquels un retour est valide après la livraison.
NO_RETURNS Aucun retour.
LIFETIME_RETURNS Un retour à vie.

RestockingFee

Frais de remise en stock Il peut s'agir d'un tarif forfaitaire ou d'un micro-pourcentage.

Champs

Champ d'union type.

type ne peut être qu'un des éléments suivants :

fixed_fee

Price

Frais de remise en stock fixes.

micro_percent

int32

Pourcentage du prix total en micros. 15 000 000 signifie que 15% du prix total seraient facturés.

ReturnMethod

Méthodes de retour disponibles.

Enums
RETURN_METHOD_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BY_MAIL À retourner par courrier postal.
IN_STORE Retour en magasin.
AT_A_KIOSK Revenez sur une borne.

ReturnShippingFee

Frais de port de retour. Il peut s'agir de frais fixes ou d'une valeur booléenne indiquant que le client paie les frais de port réels.

Champs
type

Type

Type de frais de port de retour.

fixed_fee

Price

Montant des frais de port de retour fixes. Cette valeur n'est applicable que lorsque le type est FIXED. Les frais de port de retour seront considérés comme sans frais si le type est FIXED et que cette valeur n'est pas définie.

Type

Types de frais de port de retour.

Enums
TYPE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
FIXED Les frais de port de retour sont une valeur fixe.
CUSTOMER_PAYING_ACTUAL_FEE Les clients paieront les frais de port de retour réels.

PhoneVerificationState

État de validation du numéro de téléphone.

Enums
PHONE_VERIFICATION_STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
PHONE_VERIFICATION_STATE_VERIFIED Le numéro de téléphone est validé.
PHONE_VERIFICATION_STATE_UNVERIFIED Le numéro de téléphone n'est pas validé

Programme

Définit la participation à un programme donné pour le compte spécifié.

Ces programmes permettent d'ajouter des fonctionnalités aux comptes marchands. Le programme Fiches produit sans frais en est un exemple typique. Il permet aux produits d'un marchand d'apparaître sans frais sur Google.

Champs
name

string

Identifiant. Nom de ressource du programme. Format : accounts/{account}/programs/{program}

documentation_uri

string

Uniquement en sortie. URL d'une page d'aide Merchant Center décrivant le programme.

state

State

Uniquement en sortie. État de participation du compte au programme.

active_region_codes[]

string

Uniquement en sortie. Régions dans lesquelles le compte participe activement au programme. Les régions actives sont celles où toutes les conditions du programme applicables dans ces régions sont remplies.

Les codes de région sont définis par le CLDR. Il peut s'agir d'un pays où le programme s'applique spécifiquement ou de 001 lorsque le programme s'applique à l'échelle mondiale.

unmet_requirements[]

Requirement

Uniquement en sortie. Les conditions non encore remplies pour le compte et qui ont une incidence sur la participation au programme

Prérequis

Définit une condition requise pour participer au programme.

Champs
title

string

Uniquement en sortie. Nom de l'exigence.

documentation_uri

string

Uniquement en sortie. URL d'une page d'aide décrivant l'exigence.

affected_region_codes[]

string

Uniquement en sortie. Régions actuellement concernées par cette exigence non respectées.

Les codes de région sont définis par le CLDR. Il peut s'agir d'un pays où le programme s'applique spécifiquement ou de 001 lorsque le programme s'applique à l'échelle mondiale.

État

États de participation possibles au programme pour le compte.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
NOT_ELIGIBLE Le compte n'est pas autorisé à participer au programme.
ELIGIBLE Le compte est éligible au programme.
ENABLED Le programme est activé pour le compte.

RateGroup

Définitions des groupes de tarifs de livraison. Seul le dernier est autorisé à avoir un applicable_shipping_labels vide, ce qui signifie "tout le reste". L'autre applicable_shipping_labels ne doit pas se chevaucher.

Champs
applicable_shipping_labels[]

string

Obligatoire. Liste d'étiquettes de livraison définissant les produits auxquels ce groupe de tarifs s'applique. Il s'agit d'une disjonction: une seule étiquette doit correspondre pour que le groupe de tarifs s'applique. Ce champ ne peut être vide que pour le dernier groupe de tarifs d'un service.

subtables[]

Table

Facultatif. Liste de sous-tableaux référencés par main_table. Ne peut être défini que si main_table est défini.

carrier_rates[]

CarrierRate

Facultatif. Liste des tarifs de transporteurs auxquels les main_table ou single_value peuvent faire référence.

single_value

Value

Valeur du groupe de tarifs (par exemple, taux fixe de 10 $). Ne peut être défini que si main_table et subtables ne sont pas définis.

main_table

Table

Un tableau définissant le groupe de tarifs, lorsque single_value n'est pas assez parlant. Ne peut être défini que si single_value n'est pas défini.

name

string

Facultatif. Nom du groupe de tarifs. S'il est défini, il doit être unique au sein du service de livraison.

Région

Représente une zone géographique que vous pouvez utiliser comme cible avec les services RegionalInventory et ShippingSettings. Vous pouvez définir des régions comme des ensembles de codes postaux ou, dans certains pays, à l'aide de cibles géographiques prédéfinies. Pour plus d'informations, consultez Configurer des régions .

Champs
name

string

Identifiant. Nom de ressource de la région. Format : accounts/{account}/regions/{region}

postal_code_area

PostalCodeArea

Facultatif. Liste de codes postaux définissant la région.

geotarget_area

GeoTargetArea

Facultatif. Liste de cibles géographiques qui définit la zone de la région.

regional_inventory_eligible

BoolValue

Uniquement en sortie. Indique si la région peut être utilisée dans la configuration de l'inventaire régional.

shipping_eligible

BoolValue

Uniquement en sortie. Indique si la région peut être utilisée dans la configuration des services de livraison.

display_name

string

Facultatif. Nom à afficher pour la région.

GeoTargetArea

Liste de cibles géographiques qui définit la zone de la région.

Champs
geotarget_criteria_ids[]

int64

Obligatoire. Liste non vide d'ID de zone géographique. Ils doivent tous être du même type d'emplacement (par exemple, un État).

PostalCodeArea

Liste de codes postaux définissant la région. Remarque: Toutes les régions définies à l'aide de codes postaux sont accessibles via la ressource ShippingSettings.postalCodeGroups du compte.

Champs
region_code

string

Obligatoire. Code CLDR ou pays auquel le groupe de codes postaux s'applique.

postal_codes[]

PostalCodeRange

Obligatoire. Une plage de codes postaux.

PostalCodeRange

Plage de codes postaux définissant la région.

Champs
begin

string

Obligatoire. Code postal ou format de préfixe* indiquant la limite inférieure inclue de la plage qui définit la zone. Exemples de valeurs: 94108, 9410*, 9*.

end

string

Facultatif. Code postal ou modèle de prefix* indiquant la limite supérieure inclusive de la plage qui définit la zone. Il doit avoir la même longueur que postalCodeRangeBegin: si postalCodeRangeBegin est un code postal, postalCodeRangeEnd doit également être un code postal ; si postalCodeRangeBegin est un format, postalCodeRangeEnd doit être un schéma avec la même longueur de préfixe. Facultatif: si ce champ n'est pas défini, la zone correspond à tous les codes postaux correspondant à postalCodeRangeBegin.

Obligatoire

Décrit les conditions d'utilisation devant être acceptées.

Champs
terms_of_service

string

Les conditions d'utilisation (termsOfService) à accepter.

tos_file_uri

string

URL complète du fichier des conditions d'utilisation. Ce champ est le même que TermsOfService.file_uri, mais n'est ajouté ici que pour plus de commodité.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

Message de requête pour la méthode RetrieveForApplicationTermsOfServiceAgreementState.

Champs
parent

string

Obligatoire. Compte pour lequel vous souhaitez obtenir un format "TermsOfServiceAgreementState" : accounts/{account}

RetrieveLatestTermsOfServiceRequest

Message de requête pour la méthode RetrieveLatestTermsOfService.

Champs
region_code

string

Code de région tel que défini par le CLDR. Il peut s'agir d'un pays dans lequel les conditions d'utilisation s'appliquent spécifiquement ou du nombre 001 lorsqu'elles s'appliquent à l'échelle mondiale.

kind

TermsOfServiceKind

Genre auquel s'applique cette version des conditions d'utilisation.

Row

Incluez une liste de cellules.

Champs
cells[]

Value

Obligatoire. Liste des cellules qui constituent la ligne. Doit avoir la même longueur que columnHeaders pour les tableaux à deux dimensions et une longueur de 1 pour les tableaux à une dimension.

Service

Service de livraison.

Champs
delivery_countries[]

string

Obligatoire. Code CLDR des pays auxquels le service s'applique.

rate_groups[]

RateGroup

Facultatif. Définitions des groupes de tarifs de livraison. Seul le dernier est autorisé à avoir un applicable_shipping_labels vide, ce qui signifie "tout le reste". L'autre applicable_shipping_labels ne doit pas se chevaucher.

loyalty_programs[]

LoyaltyProgram

Facultatif. Programmes de fidélité auxquels ce service de livraison est limité.

service_name

string

Obligatoire. Nom libre du service. Doit être unique dans le compte cible.

active

bool

Obligatoire. Booléen indiquant l'état actif du service de livraison.

currency_code

string

Code CLDR de la devise à laquelle ce service s'applique. Doit correspondre à celui des prix dans les groupes de tarifs.

delivery_time

DeliveryTime

Obligatoire. Temps consacré à divers aspects, de la commande à la livraison du produit.

shipment_type

ShipmentType

Il s'agit du type de lieu où ce service expédie les commandes.

minimum_order_value

Price

Montant minimal de commande pour ce service. Si cette option est définie, elle indique que les clients devront dépenser au moins ce montant. Tous les prix d'un service doivent être exprimés dans la même devise. Ne peut pas être défini avec la valeur "minimum_order_value_table".

minimum_order_value_table

MinimumOrderValueTable

Tableau des valeurs minimales de commande par magasin pour le type de retrait en magasin. Ne peut pas être défini ensemble avec minimum_order_value.

store_config

StoreConfig

Liste des magasins depuis lesquels vos produits sont livrés. Cette valeur n'est valide que pour le type de livraison en magasin.

LoyaltyProgram

Programme de fidélité proposé par un marchand.

Champs
loyalty_program_tiers[]

LoyaltyProgramTiers

Facultatif. Niveau du programme de fidélité de ce service de livraison.

program_label

string

Il s'agit du libellé du programme de fidélité défini dans les paramètres de votre programme de fidélité dans Merchant Center. Ce sous-attribut permet à Google de faire correspondre votre programme de fidélité aux offres éligibles.

LoyaltyProgramTiers

Sous-ensemble du programme de fidélité d'un marchand.

Champs
tier_label

string

Le sous-attribut libellé de niveau [tier_label] permet de distinguer les avantages de chaque niveau. Cette valeur est également définie dans les paramètres de votre programme dans Merchant Center. Elle est obligatoire pour modifier la source de données, même si votre programme de fidélité ne comporte qu'un seul niveau.

ShipmentType

Type de livraison du service de livraison.

Enums
SHIPMENT_TYPE_UNSPECIFIED Aucun type de livraison n'a été spécifié pour ce service.
DELIVERY Ce service expédie les commandes à une adresse choisie par le client.
LOCAL_DELIVERY Ce service expédie les commandes à une adresse choisie par le client. La commande est livrée par un magasin à proximité.
COLLECTION_POINT Ce service expédie les commandes à une adresse choisie par le client. La commande est expédiée depuis un point retrait.

StoreConfig

Liste des magasins depuis lesquels vos produits sont livrés. Cette valeur n'est valide que pour le type de livraison en magasin.

Champs
store_codes[]

string

Facultatif. Liste des codes de magasin proposant la livraison locale. Si ce champ est vide, all_stores doit être défini sur "true".

store_service_type

StoreServiceType

Indique si tous les magasins de ce marchand, ou certains d'entre eux, proposent la livraison locale.

cutoff_config

CutoffConfig

Les configurations liées à la livraison locale se terminent pour la journée.

service_radius

Distance

Rayon de livraison maximal Cette valeur n'est obligatoire que pour le type de livraison en magasin.

CutoffConfig

Les configurations liées à la livraison locale se terminent pour la journée.

Champs
local_cutoff_time

LocalCutoffTime

Heure de fin de la livraison locale pour la journée.

store_close_offset_hours

int64

Valable uniquement pour la livraison locale. Représente l'heure limite pour commander comme le nombre d'heures avant la fermeture du magasin. Exclusivité mutuelle avec local_cutoff_time.

no_delivery_post_cutoff

bool

Les marchands peuvent désactiver l'affichage de la livraison locale n+1 jour lorsqu'ils ont configuré un service de livraison pour la livraison locale en N jours. Par exemple, si le service de livraison définit la livraison le même jour et que la date limite est passée, si vous définissez ce champ sur true, le tarif du service de livraison calculé sera renvoyé NO_DELIVERY_POST_CUTOFF. Dans le même exemple, si ce champ est défini sur false, le délai de livraison calculé est d'un jour. Il ne s'applique qu'à la livraison locale.

LocalCutoffTime

Heure de fin de la livraison locale pour la journée.

Champs
hour

int64

Les commandes livrées en magasin doivent être passées le jour même pour être traitées le jour même.

minute

int64

Les commandes livrées localement doivent être passées d'ici le minute près pour être traitées le jour même.

StoreServiceType

Indique si tous les magasins, ou certains d'entre eux, listés par le marchand proposent la livraison locale.

Enums
STORE_SERVICE_TYPE_UNSPECIFIED Aucun type de service de magasin spécifié.
ALL_STORES Indique si tous les magasins, actuels et futurs, listés par ce marchand proposent la livraison locale.
SELECTED_STORES Indique que seuls les magasins listés dans store_codes peuvent utiliser la livraison locale.

ShippingSettings

Le [paramètre de livraison](https://support.google.com/merchants/answer/6069284) du compte marchand.

Champs
name

string

Identifiant. Nom de ressource du paramètre de livraison. Format : accounts/{account}/shippingSetting

services[]

Service

Facultatif. Liste des services du compte cible.

warehouses[]

Warehouse

Facultatif. Liste des entrepôts auxquels vous pouvez vous référer dans services.

etag

string

Obligatoire. Ce champ permet d'éviter les problèmes asynchrones. Assurez-vous que les données des paramètres de livraison n'ont pas changé entre l'appel get et l'insertion de l'appel. L'utilisateur doit procéder comme suit :

  1. Définissez le champ "etag" sur une chaîne vide pour la création initiale du paramètre de livraison.

  2. Après la création initiale, appelez la méthode get pour obtenir un etag et les données actuelles du paramètre de livraison avant d'appeler l'insertion.

  3. Remplacez-la par les informations du paramètre de livraison souhaitées.

  4. Appelez la méthode d'insertion avec les informations de paramètre de livraison souhaitées avec l'ETag obtenu à l'étape 2.

  5. si les données des paramètres de livraison ont changé entre l'étape 2 et l'étape 4 ; La demande d'insertion échouera, car l'ETag change chaque fois que les données du paramètre de livraison changent. L'utilisateur doit répéter les étapes 2 à 4 avec le nouvel ETag.

Table

Un tableau définissant le groupe de tarifs, lorsque single_value n'est pas assez parlant.

Champs
rows[]

Row

Obligatoire. Liste des lignes qui constituent la table. Doit avoir la même longueur que row_headers.

name

string

Nom de la table. Obligatoire pour les sous-tableaux, ignoré pour la table principale.

row_headers

Headers

Obligatoire. En-têtes des lignes du tableau.

column_headers

Headers

En-têtes des colonnes du tableau. Facultatif: si ce champ n'est pas défini, le tableau ne comporte qu'une seule dimension.

TaxRule

Convension du type principal

pourcentage micro : 100% = 1 000 000 et 1% = 10 000 ne peuvent pas être négatifs.

Informations sur le nexus de taxe et les paramètres associés applicables aux commandes livrées dans la zone couverte par un seul administrateur fiscal. Un Nexus est créé lorsqu'un marchand exerce ses activités dans une zone gérée par l'administrateur fiscal (seuls les États américains sont acceptés pour la configuration d'un Nexus). Si le marchand dispose d'un nexus dans un État américain, il doit payer des taxes à toutes les autorités fiscales associées à la destination de livraison. Identifiant suivant : 8

Champs
region_code

string

Code de la région dans laquelle cette règle s'applique

shipping_taxed

bool

Si cette option est définie, les frais de port sont taxés (au même taux que le produit) lors des livraisons dans la zone géographique de cet administrateur. Ne peut être défini que sur les États américains sans catégorie.

effective_time_period

Interval

Obligatoire. Période pendant laquelle cette règle entre en vigueur. Si la durée n'est pas spécifiée dans effective_time, la date de fin est ouverte dans le futur. Le début de cette période est inclusif, tandis que la fin est exclusive.

Champ d'union location. Décrivez la zone géographique à l'aide d'une plage de codes postaux ou d'un ID de critère. location ne peut être qu'un des éléments suivants :
location_id

int64

Admin_id ou criteria_id de la région dans laquelle cette règle s'applique.

post_code_range

TaxPostalCodeRange

Plage de codes postaux à laquelle la règle est applicable.

Champ d'union rate_calculation. Comment calculer le taux de taxe pour les livraisons dans la zone de cet administrateur ? Ne peut être défini que sur les États américains. rate_calculation ne peut être qu'un des éléments suivants :
use_google_rate

bool

Tarif qui dépend du lieu de livraison: si le marchand dispose d'un nexus dans l'État américain correspondant, les tarifs des autorités compétentes concernant la zone de livraison sont additionnés.

self_specified_rate_micros

int64

Taux fixe spécifié en micros, où 100% = 1_000_000. Convient aux États appliquant un régime basé sur l'origine.

TaxPostalCodeRange

Plage de codes postaux définissant la zone.

Champs
start

string

Obligatoire. Début de la plage de codes postaux, qui est également la plus petite de la plage.

end

string

Fin de la plage de codes postaux. Identique au début si aucune valeur n'est spécifiée.

TermsOfService

Une TermsOfService.

Champs
name

string

Identifiant. Nom de ressource de la version des conditions d'utilisation. Format : termsOfService/{version}

region_code

string

Code de région tel que défini par le CLDR. Il peut s'agir d'un pays où les conditions d'utilisation s'appliquent spécifiquement ou 001 lorsque le même TermsOfService peut être signé dans n'importe quel pays. Toutefois, lorsque vous signez des conditions d'utilisation applicables à l'échelle mondiale, vous devez indiquer un pays spécifique (il doit s'agir du pays de l'entreprise du marchand ou du pays de participation au programme).

kind

TermsOfServiceKind

Genre auquel s'applique cette version des conditions d'utilisation.

external

bool

Indique si cette version des conditions d'utilisation est externe. Les versions externes des conditions d'utilisation ne peuvent être acceptées que par le biais de processus externes, et non directement par le marchand via l'interface utilisateur ou l'API.

file_uri

string

URI du fichier de conditions d'utilisation qui doit être affiché pour les signataires.

TermsOfServiceAgreementState

Cette ressource représente l'état du contrat pour un compte donné et le type de conditions d'utilisation. L'état est le suivant:

  • Si le marchand a accepté des conditions d'utilisation, la valeur accepted est renseignée. Dans les autres cas, la valeur est vide.
  • Si le marchand doit signer des conditions d'utilisation, la valeur required est renseignée. Dans le cas contraire, la valeur est vide.

Notez que les valeurs obligatoire et acceptée peuvent toutes deux être présentes. Dans ce cas, les conditions d'utilisation de accepted auront une date d'expiration définie dans le champ valid_until. Vous devez accepter les conditions d'utilisation de required avant le valid_until pour que le compte conserve un contrat valide. Lorsqu'ils acceptent de nouvelles conditions d'utilisation, les tiers doivent afficher le texte associé à l'accord sur les conditions d'utilisation donné (l'URL du fichier contenant le texte est ajoutée dans le message "Obligatoire" ci-dessous sous la forme tos_file_uri). L'acceptation des conditions d'utilisation se fait en appelant la méthode "accepte" sur la ressource TermsOfService.

Champs
name

string

Identifiant. Nom de ressource de la version des conditions d'utilisation. Format : accounts/{account}/termsOfServiceAgreementState/{identifier} Le format de l'identifiant est le suivant : {TermsOfServiceKind}-{country}. Par exemple, un identifiant peut être MERCHANT_CENTER-US.

region_code

string

Code de région tel que défini par https://cldr.unicode.org/. Il s'agit du pays auquel l'État actuel s'applique.

terms_of_service_kind

TermsOfServiceKind

Type de conditions d'utilisation associé à la version spécifique.

accepted

Accepted

Conditions d'utilisation acceptées de ce type et pour le region_code associé

required

Required

Conditions d'utilisation requises

TermsOfServiceKind

Genre "TermsOfService".

Enums
TERMS_OF_SERVICE_KIND_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
MERCHANT_CENTER d'une demande d'inscription à Merchant Center.

TransitTable

Tableau du délai d'acheminement, nombre de jours ouvrés passés en transit en fonction des dimensions des lignes et des colonnes. Vous pouvez définir min_transit_days, max_transit_days ou transit_time_table, mais pas les deux.

Champs
postal_code_group_names[]

string

Obligatoire. Une liste de noms de régions Region.name . La dernière valeur peut être "all other locations". Exemple : ["zone 1", "zone 2", "all other locations"]. Les groupes de codes postaux mentionnés doivent correspondre au pays de livraison du service.

transit_time_labels[]

string

Obligatoire. Liste des libellés du délai d'acheminement. La dernière valeur peut être "all other labels". Exemple : ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

Obligatoire. S'il n'y a qu'un seul ensemble de dimensions postal_code_group_names ou transit_time_labels, plusieurs lignes comportent chacune une valeur pour cette dimension. S'il existe deux dimensions, chaque ligne correspond à un postal_code_group_names et les colonnes (valeurs) à un transit_time_labels.

TransitTimeRow

S'il n'y a qu'un seul ensemble de dimensions postal_code_group_names ou transit_time_labels, plusieurs lignes comportent chacune une valeur pour cette dimension. S'il existe deux dimensions, chaque ligne correspond à un postal_code_group_names et les colonnes (valeurs) à un transit_time_labels.

Champs
values[]

TransitTimeValue

Obligatoire. Délai d'acheminement (min.-max.) en jours ouvrés.

TransitTimeValue

Délai d'acheminement (min.-max.) en jours ouvrés.

Champs
min_transit_days

int32

Délai d'acheminement minimal en jours ouvrés. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain.

max_transit_days

int32

La valeur doit être supérieure ou égale à min_transit_days.

UnclaimHomepageRequest

Message de requête pour la méthode UnclaimHomepage.

Champs
name

string

Obligatoire. Nom de la page d'accueil dont vous ne souhaitez plus revendiquer la propriété. Format : accounts/{account}/homepage

UpdateAccountRequest

Message de requête pour la méthode UpdateAccount.

Champs
account

Account

Obligatoire. Nouvelle version du compte.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

UpdateAccountTaxRequest

Demander la mise à jour des paramètres de taxes

Champs
account_tax

AccountTax

Obligatoire. Paramètre de taxe qui sera mis à jour

update_mask

FieldMask

Liste des champs à mettre à jour

UpdateBusinessIdentityRequest

Message de requête pour la méthode UpdateBusinessIdentity.

Champs
business_identity

BusinessIdentity

Obligatoire. Nouvelle version de l'identité de l'entreprise.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

UpdateBusinessInfoRequest

Message de requête pour la méthode UpdateBusinessInfo.

Champs
business_info

BusinessInfo

Obligatoire. Nouvelle version des informations sur l'établissement.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

UpdateEmailPreferencesRequest

Message de requête pour la méthode UpdateEmailPreferences.

Champs
email_preferences

EmailPreferences

Obligatoire. Préférences relatives aux e-mails à mettre à jour.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

UpdateHomepageRequest

Message de requête pour la méthode UpdateHomepage.

Champs
homepage

Homepage

Obligatoire. Nouvelle version de la page d'accueil.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

UpdateRegionRequest

Message de requête pour la méthode UpdateRegion.

Champs
region

Region

Obligatoire. Région mise à jour.

update_mask

FieldMask

Facultatif. Masque de champ séparé par une virgule indiquant les champs à mettre à jour. Exemple : "displayName,postalCodeArea.regionCode"

UpdateUserRequest

Message de requête pour la méthode UpdateUser.

Champs
user

User

Obligatoire. Nouvelle version de l'utilisateur.

Utilisez me pour faire référence à votre propre adresse e-mail, par exemple accounts/{account}/users/me.

update_mask

FieldMask

Obligatoire. Liste des champs en cours de mise à jour.

Utilisateur

Un utilisateur.

Champs
name

string

Identifiant. Nom de ressource de l'utilisateur. Format : accounts/{account}/user/{email}

Utilisez me pour faire référence à votre propre adresse e-mail, par exemple accounts/{account}/users/me.

state

State

Uniquement en sortie. État de l'utilisateur.

access_rights[]

AccessRight

Facultatif. Les droits d'accès dont dispose l'utilisateur.

État

États possibles d'un utilisateur.

Enums
STATE_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
PENDING L'utilisateur est en attente de confirmation. Dans cet état, l'utilisateur doit d'abord accepter l'invitation avant d'effectuer d'autres actions.
VERIFIED L'utilisateur est validé.

Valeur

Valeur unique d'un groupe de tarifs ou valeur de la cellule d'un tableau de groupes de tarifs. Vous ne devez définir qu'un seul des paramètres suivants : no_shipping, flat_rate, price_percentage, carrier_rateName ou subtable_name.

Champs
no_shipping

bool

Si la valeur est "true", le produit ne peut pas être expédié. Doit être défini sur "true" et ne peut être défini que si aucun autre champ n'est défini.

flat_rate

Price

Un taux fixe. Ne peut être défini que si aucun autre champ n'est défini.

price_percentage

string

Pourcentage du prix représenté sous forme de nombre en notation décimale (par exemple, "5.4"). Ne peut être défini que si aucun autre champ n'est défini.

carrier_rate

string

Nom d'un tarif de transporteur faisant référence à un tarif de transporteur défini dans le même groupe de tarifs. Ne peut être défini que si aucun autre champ n'est défini.

subtable

string

Nom d'un sous-tableau. Ne peut être défini que dans des cellules du tableau (par exemple, pas pour des valeurs uniques) et uniquement si aucun autre champ n'est défini.

Entrepôt

Un entrepôt de traitement des commandes qui stocke et gère l'inventaire. Balise suivante: 7

Champs
name

string

Obligatoire. Nom de l'entrepôt. Doit être unique dans le compte.

shipping_address

Address

Obligatoire. Adresse de livraison de l'entrepôt.

cutoff_time

WarehouseCutoffTime

Obligatoire. Heure limite à laquelle une commande peut être acceptée et dont le traitement peut commencer. Les commandes ultérieures seront traitées le jour suivant. L'heure est basée sur le code postal de l'entrepôt.

handling_days

int64

Obligatoire. Nombre de jours nécessaires à cet entrepôt pour emballer et expédier un article. Cette valeur s'applique au niveau de l'entrepôt, mais peut être remplacée au niveau de l'offre en fonction des attributs d'un article.

business_day_config

BusinessDayConfig

Jours ouvrés de l'entrepôt. Si cette règle n'est pas configurée, la valeur est définie par défaut du lundi au vendredi.

WarehouseBasedDeliveryTime

Indique que le délai de livraison doit être calculé pour chaque entrepôt (adresse d'origine de l'expédition) en fonction des paramètres du transporteur sélectionné. Si ce champ est défini, aucun autre champ lié au délai d'acheminement dans delivery_time ne doit être défini.

Champs
carrier

string

Obligatoire. Opérateur, tel que "UPS" ou "Fedex".

carrier_service

string

Obligatoire. Service de transporteur, tel que "ground" ou "2 days". Le nom du service doit figurer dans la liste eddSupportedServices.

warehouse

string

Obligatoire. Nom de l'entrepôt. Il doit correspondre à [warehouse][ShippingSetting.warehouses.name].

WarehouseCutoffTime

Heure limite à laquelle une commande peut être acceptée et dont le traitement peut commencer. Les commandes ultérieures seront traitées le jour suivant. L'heure est basée sur le code postal de l'entrepôt.

Champs
hour

int32

Obligatoire. Heure de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le même jour par l'entrepôt. L'heure est basée sur le fuseau horaire de l'entrepôt.

minute

int32

Obligatoire. Minute de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même par l'entrepôt. Les minutes sont basées sur le fuseau horaire de l'entrepôt.