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 OAuth 2.0 Overview.

AccountsService

Service permettant de prendre en charge l'API Accounts.

CreateAndConfigureAccount

rpc CreateAndConfigureAccount(CreateAndConfigureAccountRequest) returns (Account)

Crée un compte Merchant Center individuel avec une configuration supplémentaire. Ajoute l'utilisateur à l'origine de la requête 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 OAuth 2.0 Overview.

DeleteAccount

rpc DeleteAccount(DeleteAccountRequest) returns (Empty)

Supprime le compte spécifié, quel que soit son type: compte individuel, multicompte 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. La suppression ne réussit que si le compte ne fournit de services à aucun autre compte et qu'il n'a pas d'offres traitées. Vous pouvez ignorer ce comportement à l'aide du paramètre force.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Récupère un compte de votre compte Merchant Center. Une fois un compte inséré, mis à jour ou supprimé, il peut s'écouler plusieurs minutes avant que les modifications ne prennent effet.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ListAccounts

rpc ListAccounts(ListAccountsRequest) returns (ListAccountsResponse)

Répertorie 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 MC, des comptes associés, des comptes individuels, etc. Si aucun filtre n'est fourni, les comptes auxquels l'utilisateur est directement ajouté sont renvoyés. Cette méthode est cohérente à terme. Cela signifie que les modifications telles que la création ou la mise à jour d'un compte, ou le changement de relations entre des comptes, peuvent ne pas apparaître immédiatement dans les résultats. Au lieu de cela, ces modifications se propagent sur une courte période, après quoi les informations mises à jour peuvent correspondre aux prédicats associés. Par conséquent, une recherche par nom de compte peut ne pas renvoyer de compte récemment modifié, même s'il répond au prédicat.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ListSubAccounts

rpc ListSubAccounts(ListSubAccountsRequest) returns (ListSubAccountsResponse)

Liste tous les sous-comptes d'un multicompte donné. Il s'agit d'un wrapper pratique pour la méthode ListAccounts plus puissante. Cette méthode produit les mêmes résultats que l'appel de 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

AutofeedSettingsService

Service compatible avec le paramètre autofeed.

GetAutofeedSettings

rpc GetAutofeedSettings(GetAutofeedSettingsRequest) returns (AutofeedSettings)

Récupère les paramètres des flux automatiques 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 OAuth 2.0 Overview.

UpdateAutofeedSettings

rpc UpdateAutofeedSettings(UpdateAutofeedSettingsRequest) returns (AutofeedSettings)

Met à jour les paramètres des flux automatiques 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 OAuth 2.0 Overview.

BusinessIdentityService

Service permettant de prendre en charge l'API business identity.

GetBusinessIdentity

rpc GetBusinessIdentity(GetBusinessIdentityRequest) returns (BusinessIdentity)

Récupère l'identité de 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 OAuth 2.0 Overview.

UpdateBusinessIdentity

rpc UpdateBusinessIdentity(UpdateBusinessIdentityRequest) returns (BusinessIdentity)

Met à jour l'identité de l'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 OAuth 2.0 Overview.

BusinessInfoService

Service permettant de prendre en charge l'API Business Information.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

EmailPreferencesService

Service compatible avec l'API EmailPreferences.

GetEmailPreferences

rpc GetEmailPreferences(GetEmailPreferencesRequest) returns (EmailPreferences)

Renvoie les préférences de messagerie d'un utilisateur de compte Merchant Center. Ce service ne permet que de récupérer et de mettre à jour les préférences de messagerie de l'utilisateur authentifié. 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 OAuth 2.0 Overview.

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 compte MC plutôt qu'un sous-compte du MC.

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

Il est non valide que les mises à jour spécifient une valeur d'état d'activation UNCONFIRMED.

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 OAuth 2.0 Overview.

HomepageService

Service permettant de prendre en charge une API pour la page d'accueil d'un magasin.

ClaimHomepage

rpc ClaimHomepage(ClaimHomepageRequest) returns (Homepage)

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

Si la page d'accueil est déjà revendiquée, la validation sera revérifiée (sauf si le marchand est exempté de cette procédure, ce qui l'exempte également de la validation) et une réponse positive sera renvoyée. Si la propriété ne peut plus être validée, une erreur est renvoyée, mais la revendication n'est pas annulée. En cas d'échec, un message d'erreur canonique est renvoyé: * PERMISSION_DENIED: l'utilisateur ne dispose pas des autorisations nécessaires sur ce compte MC ; * FAILED_PRECONDITION: - Le compte n'est pas un compte Merchant Center ; - Le compte MC n'a pas de page d'accueil ; - La revendication a échoué (dans ce cas, le message d'erreur contient 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

UnclaimHomepage

rpc UnclaimHomepage(UnclaimHomepageRequest) returns (Homepage)

Révoque la revendication de 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

OnlineReturnPolicyService

Ce service facilite la gestion de la configuration des conditions de retour pour les remords d'un marchand, qui incluent les conditions de retour pour les annonces et les fiches gratuites.

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

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

GetOnlineReturnPolicy

rpc GetOnlineReturnPolicy(GetOnlineReturnPolicyRequest) returns (OnlineReturnPolicy)

Récupère les conditions de retour existantes d'un marchand donné.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ListOnlineReturnPolicies

rpc ListOnlineReturnPolicies(ListOnlineReturnPoliciesRequest) returns (ListOnlineReturnPoliciesResponse)

Répertorie toutes les conditions de retour existantes d'un marchand donné.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

ProgramsService

Service de gestion de programme.

Les programmes permettent d'ajouter des fonctionnalités aux comptes marchands. C'est le cas, par exemple, du programme Fiches produit sans frais, qui permet de présenter les produits d'un marchand sur Google sans frais.

Ce service expose 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 la participation à chaque programme.

DisableProgram

rpc DisableProgram(DisableProgramRequest) returns (Program)

Désactivez 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 OAuth 2.0 Overview.

EnableProgram

rpc EnableProgram(EnableProgramRequest) returns (Program)

Activez 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

RegionsService

Gère la configuration des régions.

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

  • Region
CreateRegion

rpc CreateRegion(CreateRegionRequest) returns (Region)

Crée une définition de 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

ListRegions

rpc ListRegions(ListRegionsRequest) returns (ListRegionsResponse)

Répertorie les régions de 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

ShippingSettingsService

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

GetShippingSettings

rpc GetShippingSettings(GetShippingSettingsRequest) returns (ShippingSettings)

Récupérez des 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 OAuth 2.0 Overview.

InsertShippingSettings

rpc InsertShippingSettings(InsertShippingSettingsRequest) returns (ShippingSettings)

Remplacez le paramètre de livraison d'un marchand par le paramètre de livraison sur 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 OAuth 2.0 Overview.

TermsOfServiceAgreementStateService

Service compatible avec l'API TermsOfServiceAgreementState.

GetTermsOfServiceAgreementState

rpc GetTermsOfServiceAgreementState(GetTermsOfServiceAgreementStateRequest) returns (TermsOfServiceAgreementState)

Renvoie 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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

RetrieveLatestTermsOfService

rpc RetrieveLatestTermsOfService(RetrieveLatestTermsOfServiceRequest) returns (TermsOfService)

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

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

UserService

Service permettant de prendre en charge 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 OAuth 2.0 Overview.

DeleteUser

rpc DeleteUser(DeleteUserRequest) returns (Empty)

Supprime un utilisateur d'un compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur. L'utilisateur à supprimer ne peut pas être le dernier administrateur de ce compte. De plus, un utilisateur est protégé contre la suppression s'il est géré par Business Manager."

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

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 OAuth 2.0 Overview.

UpdateUser

rpc UpdateUser(UpdateUserRequest) returns (User)

Met à jour un utilisateur d'un 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 OAuth 2.0 Overview.

AcceptTermsOfServiceRequest

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

Champs
name

string

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

account

string

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

region_code

string

Obligatoire. Code de région tel que défini par CLDR. Il s'agit d'un pays lorsque les conditions d'utilisation s'appliquent spécifiquement à ce pays ou de 001 lorsqu'elles s'appliquent à l'ensemble du monde.

Accepté

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

Champs
terms_of_service

string

Les termsOfService acceptées.

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 des sous-comptes, du compte MC.

valid_until

Date

Lorsqu'il est défini, il indique que les TermsOfService acceptées ne sont valides que jusqu'à la fin de cette date (en UTC). Un nouveau doit être accepté avant cette date. Les informations sur les TermsOfService requises se trouvent dans le message Obligatoire.

AccessRight

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

Le message Account représente le compte d'un marchand dans les annonces Shopping. Il s'agit de l'entité principale pour gérer les données produit, les paramètres et les interactions avec les services Google et les fournisseurs externes.

Les comptes peuvent fonctionner en tant qu'entités autonomes ou faire partie d'une structure de multicompte (MC). Dans une configuration de multicompte, le compte parent gère plusieurs sous-comptes.

Pour créer un compte, vous devez configurer des attributs tels que le nom du compte, le fuseau horaire et les préférences linguistiques.

Le message Account est l'entité parente de nombreuses autres ressources, par exemple AccountRelationship, Homepage, BusinessInfo, etc.

Champs
name

string

Identifiant. Nom de la 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 pages Nom du magasin et Nom de l'entreprise.

adult_content

bool

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

test_account

bool

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

time_zone

TimeZone

Obligatoire. Fuseau horaire du compte

Lors des écritures, 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. Code de langue BCP-47 du compte, par exemple en-US ou sr-Latn.

AccountAggregation

Ce type ne comporte aucun champ.

Charge utile AccountAggregation.

AccountIssue

Un AccountIssue.

Champs
name

string

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

title

string

Titre localisé du problème.

severity

Severity

Gravité globale du problème.

impacted_destinations[]

ImpactedDestination

Impact de ce problème sur différentes destinations.

detail

string

Informations supplémentaires localisées sur le problème.

documentation_uri

string

Lien vers le centre d'aide Merchant Center fournissant plus d'informations sur le problème et sur la façon de le résoudre.

ImpactedDestination

Impact du problème sur une destination.

Champs
impacts[]

Impact

Impact (négatif) de différentes régions sur la destination donnée.

reporting_context

ReportingContextEnum

Contexte des rapports concerné.

Impact

Impact du problème sur une région.

Champs
region_code

string

Code de région CLDR auquel le problème s'applique.

severity

Severity

Gravité du problème sur la destination et la région.

Gravité

Toutes les gravités de problème possibles.

Enums
SEVERITY_UNSPECIFIED La gravité est inconnue.
CRITICAL Ce problème empêche la diffusion des offres.
ERROR Ce problème peut affecter les offres (à l'avenir) ou être un indicateur de problèmes liés aux offres.
SUGGESTION Il s'agit d'une suggestion d'amélioration.

Adresse

Adresse de livraison de l'entrepôt.

Champs
street_address

string

Rue dans l'adresse. 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. Sous-division 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").

AutofeedSettings

Collecte d'informations sur les paramètres de l'alimentation automatique.

Champs
name

string

Identifiant. Nom de ressource des paramètres de flux automatique. Format : accounts/{account}/autofeedSettings.

enable_products

bool

Obligatoire. Active ou désactive l'exploration des produits via le flux automatique pour le compte donné. Les comptes de flux automatiques doivent remplir certaines conditions, que vous pouvez vérifier dans le champ eligible. Le compte ne doit pas être une place de marché. Lorsque le flux automatique est activé pour la première fois, les produits apparaissent généralement instantanément. Lorsque vous réactivez la fonctionnalité, l'affichage des produits peut prendre jusqu'à 24 heures.

eligible

bool

Uniquement en sortie. Détermine si le marchand peut être inscrit à un flux automatique.

BusinessDayConfig

Jours ouvrés de l'entrepôt.

Champs
business_days[]

Weekday

Obligatoire. Jours ouvrés standards. Ce champ ne peut pas être vide.

Jour de la semaine

Enums
WEEKDAY_UNSPECIFIED
MONDAY
TUESDAY
WEDNESDAY
THURSDAY
FRIDAY
SATURDAY
SUNDAY

BusinessIdentity

Ensemble d'informations sur 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'entreprise s'identifie comme étant détenue par des Noirs. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Il ne s'applique pas non plus aux places de marché ni aux vendeurs sur une place de marché.

women_owned

IdentityAttribute

Facultatif. Indique si l'établissement s'identifie comme 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. Il ne s'applique pas non plus aux places de marché ni aux vendeurs sur une place de marché.

veteran_owned

IdentityAttribute

Facultatif. Indique si l'établissement s'identifie comme géré 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. Il ne s'applique pas non plus aux places de marché ni aux vendeurs sur une place de marché.

latino_owned

IdentityAttribute

Facultatif. Indique si l'entreprise s'identifie comme étant détenue par un Latino. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur US. Il ne s'applique pas non plus aux places de marché ni aux vendeurs sur une place de marché.

small_business

IdentityAttribute

Facultatif. Indique si l'entreprise 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. Il 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'une 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

Le message BusinessInfo contient des informations essentielles sur l'activité d'un marchand.

Ce message contient des informations clés sur l'établissement, telles que l'adresse physique, les coordonnées du service client et les identifiants spécifiques à la région.

Champs
name

string

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

address

PostalAddress

Facultatif. Adresse de l'établissement. Seuls les champs region_code, address_lines, postal_code, administrative_area et locality sont acceptés. Tous les autres champs sont ignorés.

phone

PhoneNumber

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

phone_verification_state

PhoneVerificationState

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

customer_service

CustomerService

Facultatif. Le service client de l'entreprise.

korean_business_registration_number

string

Facultatif. Numéro d'enregistrement d'entreprise coréen à 10 chiffres, séparé par des tirets, au format: XXX-XX-XXXXX.

CarrierRate

Liste des tarifs de transporteurs que main_table ou single_value peuvent évoquer. Les services de transporteur compatibles sont définis sur la page https://support.google.com/merchants/answer/12577710?ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.

Champs
name

string

Obligatoire. Nom du tarif du transporteur. Chaque groupe de tarifs doit avoir un nom unique.

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. Origine de livraison pour ce tarif de transporteur.

percentage_adjustment

string

Facultatif. Multiplicateur du modificateur des frais de port. Il apparaît sous la forme d'un nombre en notation décimale. Peut être négatif. Par exemple, "5.4" augmente le tarif de 5,4%, tandis que "-3" le diminue 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 $aux frais, tandis que { "amount_micros": -3, "currency_code" : "USD" } soustrait 3 $des frais.

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

overwrite

bool

Facultatif. Lorsque cette option est définie sur true, elle supprime toute revendication existante sur le site Web demandé et la remplace par une revendication du compte à l'origine de la demande.

CreateAndConfigureAccountRequest

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

Champs
account

Account

Obligatoire. Compte à créer.

users[]
(deprecated)

CreateUserRequest

Facultatif. Utilisateurs à ajouter au compte.

Ce champ est obsolète et n'existera plus une fois que l'API sortira de la version bêta. Utilisez plutôt le champ user.

user[]

AddUser

Facultatif. Utilisateurs à ajouter au compte.

service[]

AddAccountService

Obligatoire. Un service de compte entre le compte à créer et le compte du fournisseur est initialisé lors de la création. Vous devez fournir au moins un tel service. Actuellement, vous devez indiquer exactement un seul account_aggregation, ce qui signifie que vous ne pouvez créer que des sous-comptes, et non des comptes autonomes, via cette méthode. Des services account_management ou product_management supplémentaires peuvent être fournis.

AddAccountService

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

Champs
Champ d'union service_type. Type de service à ajouter. service_type ne peut être qu'un des éléments suivants :
account_aggregation

AccountAggregation

Le fournisseur est un agrégateur pour le compte. Charge utile pour le type de service "Agrégation de comptes".

provider

string

Obligatoire. Fournisseur du service. Référence à un compte tel que providers/123 ou à un fournisseur de services connu (providers/GOOGLE_ADS ou providers/GOOGLE_BUSINESS_PROFILE).

AddUser

Instructions pour ajouter un utilisateur au compte lors de sa création.

Champs
user_id

string

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

user

User

Facultatif. Informations sur l'utilisateur à ajouter. Pour le moment, seuls les droits d'accès peuvent être spécifiés.

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 pour toutes les régions du 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 la 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

Facultatif. Utilisateur à créer.

CustomerService

Informations sur le service client

Champs
uri

string

Facultatif. URI du service client.

email

string

Facultatif. Adresse e-mail du service client.

phone

PhoneNumber

Facultatif. Numéro de téléphone du service client.

CutoffTime

Définition de l'heure limite en 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 du 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}

force

bool

Facultatif. Si la valeur est true, le compte est supprimé, même s'il fournit des services à d'autres comptes ou a traité des offres.

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 à l'aide de me plutôt que d'une adresse e-mail comme dans accounts/{account}/users/me.

DeliveryTime

Temps passé dans les 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é par entrepôt (lieu d'expédition) en fonction des paramètres du transporteur sélectionné. Lorsqu'il est défini, 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 signifie livraison le jour même, 1, livraison le lendemain. min_transit_days, max_transit_days ou transit_time_table doivent être définis, mais pas les deux.

max_transit_days

int32

Nombre maximal de jours ouvrés passés en acheminement. 0 signifie livraison le jour même, 1, livraison le lendemain. Doit être supérieur ou égal à min_transit_days.

cutoff_time

CutoffTime

Définition de l'heure limite en jours ouvrés. Si elle n'est pas configurée, l'heure limite sera par défaut 8h00 PST.

min_handling_days

int32

Nombre minimal de jours ouvrés passés avant l'expédition d'une commande. 0 signifie expédié le jour même, 1, expédié le lendemain. "min_handling_days" et "max_handling_days" doivent être définis ou non en même temps.

max_handling_days

int32

Nombre maximal de jours ouvrés passés avant l'expédition d'une commande. 0 signifie expédié le jour même, 1, expédié le lendemain. Doit être supérieur ou égal à min_handling_days. "min_handling_days" et "max_handling_days" doivent être définis ou non en même temps.

transit_time_table

TransitTable

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

handling_business_day_config

BusinessDayConfig

Jours ouvrés pendant lesquels les commandes peuvent être traitées. Si vous ne le faites pas, les jours ouvrés du lundi au vendredi seront considérés comme les jours de livraison.

transit_business_day_config

BusinessDayConfig

Jours ouvrés pendant lesquels les commandes peuvent être en transit. Si vous ne le faites pas, les jours ouvrés du lundi au vendredi seront considérés comme les jours de livraison.

DisableProgramRequest

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

Champs
name

string

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

Distance

Rayon de livraison maximal. Cette information n'est requise que pour le type de livraison en magasin.

Champs
value

int64

Valeur entière de la distance.

unit

Unit

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

Unité

L'unité peut varier selon le 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 de messagerie n'incluent pas les annonces obligatoires, car les utilisateurs ne peuvent pas les désactiver.

Champs
name

string

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

news_and_tips

OptInState

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

OptInState

État d'activation de la préférence concernant les 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-mails.
OPTED_IN L'utilisateur a accepté de recevoir ce type d'e-mails.
UNCONFIRMED L'utilisateur a activé la réception de ce type d'e-mails et l'e-mail de confirmation a été envoyé, mais l'utilisateur n'a pas encore confirmé l'activation (ne s'applique qu'à certains pays).

EnableProgramRequest

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

Champs
name

string

Obligatoire. Nom du programme pour lequel activer la participation pour le compte donné. 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}

GetAutofeedSettingsRequest

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

Champs
name

string

Obligatoire. Nom de ressource des paramètres de flux automatique. Format : accounts/{account}/autofeedSettings

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 la 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 la 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 la 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 à l'aide de me plutôt que d'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 devez définir exactement l'une des valeurs prices, weights, num_items, postal_code_group_names ou location.

Champs
prices[]

Price

Obligatoire. Liste de limites supérieures inclusives de prix de commande. La valeur du dernier prix peut être infinie en définissant price amount_micros = -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 avoir la même devise. 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 valeur de la dernière pondération peut être infinie en définissant price amount_micros = -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". Tous les poids d'un service doivent avoir la même unité. 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 d'un nombre inclusif de limites supérieures d'articles. 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". 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. Ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

locations[]

LocationIdSet

Obligatoire. Liste d'ID de zone géographique. Ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.

Page d'accueil

Le message Homepage représente la page d'accueil de la boutique d'un marchand dans le système.

La page d'accueil d'un marchand est le domaine principal sur lequel les clients interagissent avec son magasin.

La page d'accueil peut être revendiquée et validée comme preuve de propriété. Elle permet au marchand de débloquer des fonctionnalités nécessitant un site Web validé. Pour en savoir plus, consultez Comprendre la validation des URL des boutiques en ligne.

Champs
name

string

Identifiant. Nom de la 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 de la boutique

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. Élément parent qui possède cette collection de problèmes. Format : accounts/{account}

page_size

int32

Facultatif. Nombre maximal de problèmes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 utilisateurs au maximum sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 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 de la réponse comporteront des champs lisibles dans la langue donnée. Le format est BCP-47, par exemple en-US ou sr-Latn. Si aucune valeur n'est fournie, en-US est utilisé.

time_zone

string

Facultatif. Fuseau horaire IANA utilisé pour localiser les heures dans des champs lisibles par l'homme. Par exemple, "Amérique/Los_Angeles". Si ce paramètre n'est pas défini, "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.

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 sont réduites à 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. Ne renvoie que 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

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 afficher 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 du marchand donné est inférieur à pageSize. La valeur par défaut est 10. La valeur maximale est 100. Si une valeur supérieure à la valeur maximale est spécifiée, pageSize est défini par défaut sur la valeur maximale.

page_token

string

Facultatif. Jeton de page reçu d'un appel ListOnlineReturnPolicies précédent. Fournissez 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. Jeton renvoyé sous la forme 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 tous les programmes doivent être récupérés. Format : accounts/{account}

page_size

int32

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

page_token

string

Facultatif. Jeton de continuation 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 du 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 lister 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 sont 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. Fournisseur de services d'agrégation. Format : providers/{providerId}

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 sont réduites à 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. Élément 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 sont renvoyés. La valeur maximale est 100. Les valeurs supérieures sont réduites à 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 d'ID de zone géographique. 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 d'ID de zone géographique remplie. Ils doivent tous avoir le même type d'emplacement (par exemple, un état).

MinimumOrderValueTable

Tableau des valeurs minimales de commande par magasin pour le type de traitement "Retrait en magasin".

Champs
store_code_set_with_movs[]

StoreCodeSetWithMov

Obligatoire. Liste des ensembles de codes de magasin partageant le même montant minimal de commande. Vous devez spécifier au moins deux ensembles, et le dernier doit être vide, ce qui signifie "MOV pour tous les autres magasins". Chaque code de magasin ne peut apparaître qu'une seule fois dans l'ensemble. Tous les prix d'un service doivent avoir la même devise.

StoreCodeSetWithMov

Liste des ensembles de codes de magasin partageant la même valeur minimale de commande. Vous devez spécifier au moins deux ensembles, et le dernier doit être vide, ce qui signifie "MOV pour tous les autres magasins". Chaque code de magasin ne peut apparaître qu'une seule fois dans l'ensemble. Tous les prix d'un service doivent avoir la même devise.

Champs
store_codes[]

string

Facultatif. Liste de codes de magasin uniques ou vide pour la valeur par défaut.

value

Price

Valeur minimale de commande pour les magasins donnés.

OnlineReturnPolicy

Objet Conditions de retour en ligne. Il est actuellement utilisé pour représenter les conditions de retour des programmes d'annonces et de fiches gratuites.

Champs
name

string

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

return_policy_id

string

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

label

string

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

countries[]

string

Obligatoire. Immuable. Pays de vente dans lesquels les conditions de retour s'appliquent. Les valeurs doivent être des codes ISO 3166 à deux lettres valides.

policy

Policy

Conditions de retour.

seasonal_overrides[]

SeasonalOverride

Facultatif. Remplacements de la règle générale pour les commandes passées pendant un ensemble spécifique d'intervalles de temps.

restocking_fee

RestockingFee

Frais de remise en stock qui s'appliquent à toutes les catégories de motifs de retour. Si cette valeur n'est pas définie, elle sera considérée comme des frais de restockage sans frais.

return_methods[]

ReturnMethod

Méthodes de retour permettant aux clients de retourner un article. Cette valeur ne doit pas être vide, sauf si le type de politique de retour est "noReturns".

item_conditions[]

ItemCondition

Les conditions d'acceptation des retours ne doivent pas être vides, sauf si le type de conditions de retour est "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

Obligatoire. URI des conditions de retour. Google peut l'utiliser pour vérifier la validité du règlement. Il doit s'agir d'une URL valide.

accept_defective_only

bool

Ce champ indique si le marchand n'accepte les retours que pour les produits défectueux. Il est obligatoire.

process_refund_days

int32

Ce champ facultatif indique le nombre de jours nécessaires aux marchands pour traiter les remboursements.

accept_exchange

bool

Ce champ indique si le marchand autorise les clients à échanger des produits. Il est obligatoire.

ItemCondition

État des articles disponibles.

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

Règle

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 la livraison, un jour étant défini comme 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 Retours à vie.

RestockingFee

Les frais de remise en stock. Il peut s'agir d'un montant fixe 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 sera facturé.

ReturnMethod

Méthodes de retour disponibles.

Enums
RETURN_METHOD_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
BY_MAIL Retour par envoi postal
IN_STORE Retournez-le en magasin.
AT_A_KIOSK Retourner dans un distributeur automatique.

ReturnShippingFee

Frais de port de retour. Il peut s'agir d'un montant fixe ou d'une valeur booléenne pour indiquer que le client paie les frais de port réels.

Champs
type

Type

Obligatoire. Type de frais de port de retour.

fixed_fee

Price

Montant fixe des frais de port de retour. Cette valeur ne s'applique que lorsque le type est FIXED. Nous considérerons les frais de retour 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.

SeasonalOverride

Suivant: 5

Champs
label

string

Obligatoire. Nom à afficher de ce forçage saisonnier dans Merchant Center.

begin

Date

Obligatoire. Définit la période pendant laquelle cette exception saisonnière s'applique. Les dates de début et de fin sont inclusives et doivent être au format décimal (par exemple, 20250115). Les dates des exceptions saisonnières ne doivent pas se chevaucher.

end

Date

Obligatoire. Date de fin de l'exception saisonnière (incluse).

policy

Policy

Obligatoire. Conditions de retour pour la période donnée.

PhoneVerificationState

État de la 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 téléphone est validé.
PHONE_VERIFICATION_STATE_UNVERIFIED Le téléphone n'est pas validé

Programme

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

Les programmes permettent d'ajouter des fonctionnalités aux comptes marchands. C'est le cas, par exemple, du programme Fiches produit sans frais, qui permet de présenter les produits d'un marchand sur Google sans frais.

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 pour lesquelles toutes les exigences du programme les concernant ont été remplies.

Les codes de région sont définis par le CLDR. Il s'agit d'un pays où le programme s'applique spécifiquement ou de 001 lorsque le programme s'applique dans le monde entier.

unmet_requirements[]

Requirement

Uniquement en sortie. Exigences auxquelles le compte n'a pas encore satisfait, ce qui empêche sa participation au programme.

Exigence

Définit une exigence spécifiée pour la participation 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 le non-respect de cette exigence

Les codes de région sont définis par le CLDR. Il s'agit d'un pays où le programme s'applique spécifiquement ou de 001 lorsque le programme s'applique dans le monde entier.

État

États de participation au programme possibles pour le compte.

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

RateGroup

Définitions des groupes de frais de port. Seul le dernier est autorisé à avoir applicable_shipping_labels vide, ce qui signifie dans ce cas précis "Tout le reste". L'autre applicable_shipping_labels ne doit pas se superposer.

Champs
applicable_shipping_labels[]

string

Obligatoire. Liste d'étiquettes de livraison définissant les produits auxquels s'applique ce groupe de tarifs. Il s'agit d'une disjonction: seule une étiquette doit correspondre pour que le groupe de taux s'applique. Il ne peut être vide que pour le dernier groupe de taxes 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 que main_table ou single_value peuvent évoquer.

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. Si défini, doit être unique dans le service de livraison.

Région

Représente une région 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 en savoir plus, consultez Configurer des régions .

Champs
name

string

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

postal_code_area

PostalCodeArea

Facultatif. Liste des codes postaux qui définissent la région.

geotarget_area

GeoTargetArea

Facultatif. Liste des zones géographiques qui définissent 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 de la région.

GeoTargetArea

Liste des zones géographiques qui définissent la région.

Champs
geotarget_criteria_ids[]

int64

Obligatoire. Liste d'ID de zone géographique remplie. Ils doivent tous avoir le même type d'emplacement (par exemple, un état).

PostalCodeArea

Liste des codes postaux qui définissent la zone de 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 territoire CLDR ou pays auquel s'applique le groupe de codes postaux.

postal_codes[]

PostalCodeRange

Obligatoire. Plage de codes postaux.

PostalCodeRange

Plage de codes postaux qui définit la zone de la région.

Champs
begin

string

Obligatoire. Code postal ou modèle de prefix* 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 inclue de la plage qui définit la zone. Il doit avoir la même longueur que postalCodeRangeBegin: si postalCodeRangeBegin est un code postal, alors postalCodeRangeEnd doit l'être également ; si postalCodeRangeBegin est un modèle, alors postalCodeRangeEnd doit être un modèle avec la même longueur de préfixe. Facultatif: si elle n'est pas définie, la zone correspond à tous les codes postaux de postalCodeRangeBegin.

Obligatoire

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

Champs
terms_of_service

string

Les termsOfService à accepter.

tos_file_uri

string

URL complète du fichier des conditions d'utilisation. Ce champ est identique à TermsOfService.file_uri. Il est ajouté ici à des fins de commodité uniquement.

RetrieveForApplicationTermsOfServiceAgreementStateRequest

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

Champs
parent

string

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

RetrieveLatestTermsOfServiceRequest

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

Champs
region_code

string

Obligatoire. Code de région tel que défini par CLDR. Il s'agit d'un pays lorsque les conditions d'utilisation s'appliquent spécifiquement à ce pays ou de 001 lorsqu'elles s'appliquent à l'ensemble du monde.

kind

TermsOfServiceKind

Obligatoire. Type auquel cette version des conditions d'utilisation s'applique.

Ligne

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 frais de port. Seul le dernier est autorisé à avoir applicable_shipping_labels vide, ce qui signifie dans ce cas précis "Tout le reste". L'autre applicable_shipping_labels ne doit pas se superposer.

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. Un booléen indiquant l'état actif du service de livraison.

currency_code

string

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

delivery_time

DeliveryTime

Obligatoire. Temps passé dans les divers aspects, de la commande à la livraison du produit.

shipment_type

ShipmentType

Type de lieux vers lesquels ce service expédie les commandes.

minimum_order_value

Price

Montant minimal de commande pour ce service. Si défini, indique que les clients devront dépenser au moins ce montant. Tous les prix d'un service doivent avoir la même devise. Ne peut pas être défini avec "minimum_order_value_table".

minimum_order_value_table

MinimumOrderValueTable

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

store_config

StoreConfig

Liste des magasins depuis lesquels vos produits sont livrés. Cette option 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 d'un programme de fidélité de marchand.

Champs
tier_label

string

Le sous-attribut libellé de niveau [tier_label] permet de distinguer les avantages associés à chaque niveau. Cette valeur est également définie dans les paramètres de votre programme dans Merchant Center. Elle est obligatoire pour modifier les sources 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 Ce service n'a pas spécifié le type d'expédition.
DELIVERY Ce service livre les commandes à une adresse choisie par le client.
LOCAL_DELIVERY Ce service livre les commandes à une adresse choisie par le client. La commande est expédiée depuis un magasin à proximité.
COLLECTION_POINT Ce service livre 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 option n'est valide que pour le type de livraison en magasin.

Champs
store_codes[]

string

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

store_service_type

StoreServiceType

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

cutoff_config

CutoffConfig

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

service_radius

Distance

Rayon de livraison maximal. Cette information n'est requise que pour le type de livraison en magasin.

CutoffConfig

Les configurations liées à la livraison locale expirent 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

Uniquement valable pour le traitement en local. Représente l'heure limite sous la forme d'un nombre d'heures avant la fermeture du magasin. S'exclut mutuellement avec local_cutoff_time.

no_delivery_post_cutoff

bool

Les marchands peuvent désactiver l'affichage de la livraison en magasin sous n + 1 jour lorsqu'un service de livraison est configuré pour la livraison en magasin sous n jours. Par exemple, si le service de livraison définit la livraison le même jour et que l'heure limite est passée, définir ce champ sur true entraîne le retour de NO_DELIVERY_POST_CUTOFF pour le tarif du service de livraison calculé. Dans le même exemple, si vous définissez ce champ sur false, le délai de livraison calculé est d'un jour. Cette option n'est disponible que pour la livraison en magasin.

LocalCutoffTime

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

Champs
hour

int64

Heure limite à laquelle les commandes de livraison locale doivent être passées pour être traitées le même jour.

minute

int64

Minute à laquelle les commandes de livraison locale doivent être passées pour être traitées le même jour.

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 Le type de service du magasin n'a pas été 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 sont éligibles à la livraison locale.

ShippingSettings

Paramètre de livraison du compte marchand.

Champs
name

string

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

services[]

Service

Facultatif. La liste des services du compte cible.

warehouses[]

Warehouse

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

etag

string

Obligatoire. Ce champ permet d'éviter les problèmes d'incohérence. Assurez-vous que les données de paramètres de livraison n'ont pas changé entre l'appel "get" et l'appel "insert". L'utilisateur doit suivre les étapes suivantes :

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

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

  3. Modifiez les informations de livraison souhaitées.

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

  5. Si les données des paramètres de livraison ont changé entre les étapes 2 et 4. La demande d'insertion échouera, car l'étiquette d'article 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 le tableau. Doit avoir la même longueur que row_headers.

name

string

Nom de la table. Obligatoire pour les sous-tableaux, ignoré pour le tableau principal.

row_headers

Headers

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

column_headers

Headers

En-têtes des colonnes du tableau. Facultatif: s'il n'est pas défini, le tableau n'a qu'une seule dimension.

TermsOfService

Le message TermsOfService représente une version spécifique des conditions d'utilisation que les marchands doivent accepter pour accéder à certaines fonctionnalités ou services (voir https://support.google.com/merchants/answer/160173)).

Ce message est important pour le processus d'intégration, car il permet de s'assurer que les marchands acceptent les accords juridiques nécessaires pour utiliser le service. Les marchands peuvent récupérer les dernières conditions d'utilisation pour un kind et un region donnés via RetrieveLatestTermsOfService, et les accepter si nécessaire via AcceptTermsOfService.

Champs
name

string

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

region_code

string

Code de région tel que défini par CLDR. Il s'agit d'un pays où les conditions d'utilisation s'appliquent spécifiquement à ce pays ou de 001 lorsque le même TermsOfService peut être signé dans n'importe quel pays. Toutefois, notez que lorsque vous signez des conditions d'utilisation qui s'appliquent dans le monde entier, 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

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

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 via des processus externes et non directement par le marchand via l'UI ou l'API.

file_uri

string

URI du fichier des conditions d'utilisation qui doit être affiché aux utilisateurs qui s'inscrivent.

TermsOfServiceAgreementState

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

  • Si le marchand a accepté des conditions d'utilisation: accepted (accepté) sera renseigné, sinon il sera vide.
  • Si le marchand doit signer des conditions d'utilisation, obligatoire sera renseigné, sinon il sera vide.

Notez que les valeurs required (obligatoire) et accepted (accepté) peuvent être présentes. Dans ce cas, une date d'expiration sera définie dans le champ valid_until des conditions d'utilisation de accepted. Les conditions d'utilisation de required doivent être acceptées avant le valid_until pour que le compte reste valide. Lorsque vous acceptez de nouvelles conditions d'utilisation, nous attendons des tiers qu'ils affichent le texte associé au contrat de 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 effective des conditions d'utilisation s'effectue en appelant accept sur la ressource TermsOfService.

Champs
name

string

Identifiant. Nom de la 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 le suivant: MERCHANT_CENTER-US

region_code

string

Code de région tel que défini sur 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 en question.

accepted

Accepted

Conditions d'utilisation acceptées de ce type et pour le code de région associé

required

Required

Les conditions d'utilisation requises

TermsOfServiceKind

Type TermsOfService.

Enums
TERMS_OF_SERVICE_KIND_UNSPECIFIED Valeur par défaut. Cette valeur n'est pas utilisée.
MERCHANT_CENTER Application Merchant Center

TransitTable

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

Champs
postal_code_group_names[]

string

Obligatoire. Liste des 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 de délai d'acheminement. La dernière valeur peut être "all other labels". Exemple : ["food", "electronics", "all other labels"].

rows[]

TransitTimeRow

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

TransitTimeRow

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

Champs
values[]

TransitTimeValue

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

TransitTimeValue

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

Champs
min_transit_days

int32

Plage de durée d'acheminement minimale en jours ouvrés. 0 signifie livraison le jour même, 1, livraison le lendemain.

max_transit_days

int32

Doit être supérieur ou égal à min_transit_days.

UnclaimHomepageRequest

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

Champs
name

string

Obligatoire. Nom de la page d'accueil à abandonner. 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

Facultatif. Liste des champs mis à jour.

Les champs suivants sont acceptés (dans snake_case et lowerCamelCase):

  • account_name
  • adult_content
  • language_code
  • time_zone

UpdateAutofeedSettingsRequest

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

Champs
autofeed_settings

AutofeedSettings

Obligatoire. Nouvelle version du paramètre de flux automatique.

update_mask

FieldMask

Obligatoire. Liste des champs mis à 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

Facultatif. Liste des champs mis à jour.

Les champs suivants sont acceptés (dans snake_case et lowerCamelCase):

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

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

Facultatif. Liste des champs mis à jour.

Les champs suivants sont acceptés (dans snake_case et lowerCamelCase):

  • address
  • customer_service
  • korean_business_registration_number

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 mis à jour.

Les champs suivants sont acceptés (dans snake_case et lowerCamelCase):

  • news_and_tips

UpdateHomepageRequest

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

Champs
homepage

Homepage

Obligatoire. Nouvelle version de la page d'accueil.

update_mask

FieldMask

Facultatif. Liste des champs mis à jour.

Les champs suivants sont acceptés (dans snake_case et lowerCamelCase):

  • uri

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

Facultatif. Liste des champs mis à jour.

Les champs suivants sont acceptés (à la fois dans snake_case et lowerCamelCase):

  • access_rights

Utilisateur

Le message User représente un utilisateur associé à un compte Merchant Center. Il permet de gérer les autorisations et les droits d'accès des utilisateurs dans le compte. Pour en savoir plus, consultez les questions fréquentes sur les utilisateurs et les niveaux d'accès.

Champs
name

string

Identifiant. Nom de la 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 devez définir exactement une valeur parmi no_shipping, flat_rate, price_percentage, carrier_rateName et subtable_name.

Champs
no_shipping

bool

Si "Vrai", le produit ne peut pas être expédié. Doit être sur "Vrai" lors de sa définition, ne peut être défini que si aucun autre champ n'est défini.

flat_rate

Price

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

price_percentage

string

Pourcentage du prix représenté sous la forme d'un 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 de 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, qui stocke et gère l'inventaire.

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 commencer à être traitée. Les commandes passées plus tard 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 est définie 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 ce champ n'est pas défini, la valeur par défaut est "du lundi au vendredi".

WarehouseBasedDeliveryTime

Indique que le délai de livraison doit être calculé par entrepôt (lieu d'expédition) en fonction des paramètres du transporteur sélectionné. Lorsqu'il est défini, aucun autre champ lié au temps de trajet dans delivery_time ne doit être défini.

Champs
carrier

string

Obligatoire. Transporteur, tel que "UPS" ou "Fedex". opérateurs compatibles

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 à [entrepôt][ShippingSetting.warehouses.name]

WarehouseCutoffTime

Heure limite à laquelle une commande peut être acceptée et commencer à être traitée. Les commandes passées plus tard 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 jour même 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 même jour par l'entrepôt. La minute est basée sur le fuseau horaire de l'entrepôt.