Index
AccountIssueService
(interface)AccountsService
(interface)AutofeedSettingsService
(interface)BusinessIdentityService
(interface)BusinessInfoService
(interface)EmailPreferencesService
(interface)HomepageService
(interface)OnlineReturnPolicyService
(interface)ProgramsService
(interface)RegionsService
(interface)ShippingSettingsService
(interface)TermsOfServiceAgreementStateService
(interface)TermsOfServiceService
(interface)UserService
(interface)AcceptTermsOfServiceRequest
(message)Accepted
(message)AccessRight
(enum)Account
(message)AccountAggregation
(message)AccountIssue
(message)AccountIssue.ImpactedDestination
(message)AccountIssue.ImpactedDestination.Impact
(message)AccountIssue.Severity
(enum)Address
(message)AutofeedSettings
(message)BusinessDayConfig
(message)BusinessDayConfig.Weekday
(enum)BusinessIdentity
(message)BusinessIdentity.IdentityAttribute
(message)BusinessIdentity.IdentityAttribute.IdentityDeclaration
(enum)BusinessIdentity.PromotionsConsent
(enum)BusinessInfo
(message)CarrierRate
(message)ClaimHomepageRequest
(message)CreateAndConfigureAccountRequest
(message)CreateAndConfigureAccountRequest.AddAccountService
(message)CreateAndConfigureAccountRequest.AddUser
(message)CreateRegionRequest
(message)CreateUserRequest
(message)CustomerService
(message)CutoffTime
(message)DeleteAccountRequest
(message)DeleteRegionRequest
(message)DeleteUserRequest
(message)DeliveryTime
(message)DisableProgramRequest
(message)Distance
(message)Distance.Unit
(enum)EmailPreferences
(message)EmailPreferences.OptInState
(enum)EnableProgramRequest
(message)GetAccountRequest
(message)GetAutofeedSettingsRequest
(message)GetBusinessIdentityRequest
(message)GetBusinessInfoRequest
(message)GetEmailPreferencesRequest
(message)GetHomepageRequest
(message)GetOnlineReturnPolicyRequest
(message)GetProgramRequest
(message)GetRegionRequest
(message)GetShippingSettingsRequest
(message)GetTermsOfServiceAgreementStateRequest
(message)GetTermsOfServiceRequest
(message)GetUserRequest
(message)Headers
(message)Homepage
(message)InsertShippingSettingsRequest
(message)ListAccountIssuesRequest
(message)ListAccountIssuesResponse
(message)ListAccountsRequest
(message)ListAccountsResponse
(message)ListOnlineReturnPoliciesRequest
(message)ListOnlineReturnPoliciesResponse
(message)ListProgramsRequest
(message)ListProgramsResponse
(message)ListRegionsRequest
(message)ListRegionsResponse
(message)ListSubAccountsRequest
(message)ListSubAccountsResponse
(message)ListUsersRequest
(message)ListUsersResponse
(message)LocationIdSet
(message)MinimumOrderValueTable
(message)MinimumOrderValueTable.StoreCodeSetWithMov
(message)OnlineReturnPolicy
(message)OnlineReturnPolicy.ItemCondition
(enum)OnlineReturnPolicy.Policy
(message)OnlineReturnPolicy.Policy.Type
(enum)OnlineReturnPolicy.RestockingFee
(message)OnlineReturnPolicy.ReturnMethod
(enum)OnlineReturnPolicy.ReturnShippingFee
(message)OnlineReturnPolicy.ReturnShippingFee.Type
(enum)OnlineReturnPolicy.SeasonalOverride
(message)PhoneVerificationState
(enum)Program
(message)Program.Requirement
(message)Program.State
(enum)RateGroup
(message)Region
(message)Region.GeoTargetArea
(message)Region.PostalCodeArea
(message)Region.PostalCodeArea.PostalCodeRange
(message)Required
(message)RetrieveForApplicationTermsOfServiceAgreementStateRequest
(message)RetrieveLatestTermsOfServiceRequest
(message)Row
(message)Service
(message)Service.LoyaltyProgram
(message)Service.LoyaltyProgram.LoyaltyProgramTiers
(message)Service.ShipmentType
(enum)Service.StoreConfig
(message)Service.StoreConfig.CutoffConfig
(message)Service.StoreConfig.CutoffConfig.LocalCutoffTime
(message)Service.StoreConfig.StoreServiceType
(enum)ShippingSettings
(message)Table
(message)TermsOfService
(message)TermsOfServiceAgreementState
(message)TermsOfServiceKind
(enum)TransitTable
(message)TransitTable.TransitTimeRow
(message)TransitTable.TransitTimeRow.TransitTimeValue
(message)UnclaimHomepageRequest
(message)UpdateAccountRequest
(message)UpdateAutofeedSettingsRequest
(message)UpdateBusinessIdentityRequest
(message)UpdateBusinessInfoRequest
(message)UpdateEmailPreferencesRequest
(message)UpdateHomepageRequest
(message)UpdateRegionRequest
(message)UpdateUserRequest
(message)User
(message)User.State
(enum)Value
(message)Warehouse
(message)WarehouseBasedDeliveryTime
(message)WarehouseCutoffTime
(message)
AccountIssueService
Service compatible avec l'API AccountIssueService
.
ListAccountIssues |
---|
Répertorie tous les problèmes liés à un compte Merchant Center.
|
AccountsService
Service permettant de prendre en charge l'API Accounts.
CreateAndConfigureAccount |
---|
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.
|
DeleteAccount |
---|
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
|
GetAccount |
---|
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.
|
ListAccounts |
---|
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.
|
ListSubAccounts |
---|
Liste tous les sous-comptes d'un multicompte donné. Il s'agit d'un wrapper pratique pour la méthode
|
UpdateAccount |
---|
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.
|
AutofeedSettingsService
Service compatible avec le paramètre autofeed.
GetAutofeedSettings |
---|
Récupère les paramètres des flux automatiques d'un compte.
|
UpdateAutofeedSettings |
---|
Met à jour les paramètres des flux automatiques d'un compte.
|
BusinessIdentityService
Service permettant de prendre en charge l'API business identity.
GetBusinessIdentity |
---|
Récupère l'identité de l'entreprise d'un compte.
|
UpdateBusinessIdentity |
---|
Met à jour l'identité de l'entreprise d'un compte. L'exécution de cette méthode nécessite un accès administrateur.
|
BusinessInfoService
Service permettant de prendre en charge l'API Business Information.
GetBusinessInfo |
---|
Récupère les informations sur l'entreprise d'un compte.
|
UpdateBusinessInfo |
---|
Met à jour les informations sur l'établissement d'un compte. L'exécution de cette méthode nécessite un accès administrateur.
|
EmailPreferencesService
Service compatible avec l'API EmailPreferences
.
GetEmailPreferences |
---|
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é.
|
UpdateEmailPreferences |
---|
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é.
|
HomepageService
Service permettant de prendre en charge une API pour la page d'accueil d'un magasin.
ClaimHomepage |
---|
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).
|
GetHomepage |
---|
Récupère la page d'accueil d'un magasin.
|
UnclaimHomepage |
---|
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.
|
UpdateHomepage |
---|
Met à jour la page d'accueil d'un magasin. L'exécution de cette méthode nécessite un accès administrateur.
|
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 |
---|
Récupère les conditions de retour existantes d'un marchand donné.
|
ListOnlineReturnPolicies |
---|
Répertorie toutes les conditions de retour existantes d'un marchand donné.
|
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 |
---|
Désactivez la participation au programme spécifié pour le compte. L'exécution de cette méthode nécessite un accès administrateur.
|
EnableProgram |
---|
Activez la participation au programme spécifié pour le compte. L'exécution de cette méthode nécessite un accès administrateur.
|
GetProgram |
---|
Récupère le programme spécifié pour le compte.
|
ListPrograms |
---|
Récupère tous les programmes du compte.
|
RegionsService
Gère la configuration des régions.
Cette API définit le modèle de ressource suivant:
Region
CreateRegion |
---|
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.
|
DeleteRegion |
---|
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.
|
GetRegion |
---|
Récupère une région définie dans votre compte Merchant Center.
|
ListRegions |
---|
Répertorie les régions de votre compte Merchant Center.
|
UpdateRegion |
---|
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.
|
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 |
---|
Récupérez des informations sur les paramètres de livraison.
|
InsertShippingSettings |
---|
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.
|
TermsOfServiceAgreementStateService
Service compatible avec l'API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Renvoie l'état d'un accord sur les conditions d'utilisation.
|
RetrieveForApplicationTermsOfServiceAgreementState |
---|
Récupère l'état de l'accord pour les conditions d'utilisation de l'application.
|
TermsOfServiceService
Service compatible avec l'API TermsOfService
.
AcceptTermsOfService |
---|
Accepte un
|
GetTermsOfService |
---|
Récupère l'
|
RetrieveLatestTermsOfService |
---|
Récupère la dernière version de
|
UserService
Service permettant de prendre en charge l'API utilisateur.
CreateUser |
---|
Crée un utilisateur de compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.
|
DeleteUser |
---|
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."
|
GetUser |
---|
Récupère un utilisateur d'un compte Merchant Center.
|
ListUsers |
---|
Répertorie tous les utilisateurs d'un compte Merchant Center.
|
UpdateUser |
---|
Met à jour un utilisateur d'un compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.
|
AcceptTermsOfServiceRequest
Message de requête pour la méthode AcceptTermsOfService
.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource de la version des conditions d'utilisation. Format : |
account |
Obligatoire. Compte pour lequel accepter les conditions d'utilisation. |
region_ |
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_ |
Les termsOfService acceptées. |
accepted_ |
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_ |
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 |
Identifiant. Nom de la ressource du compte. Format : |
account_ |
Uniquement en sortie. Numéro du compte. |
account_ |
Obligatoire. Nom lisible du compte. Pour en savoir plus, consultez les pages Nom du magasin et Nom de l'entreprise. |
adult_ |
Indique si ce compte inclut du contenu réservé aux adultes. |
test_ |
Uniquement en sortie. Indique s'il s'agit d'un compte de test. |
time_ |
Obligatoire. Fuseau horaire du compte Lors des écritures, Pour les lectures, |
language_ |
Obligatoire. Code de langue BCP-47 du compte, par exemple |
AccountAggregation
Ce type ne comporte aucun champ.
Charge utile AccountAggregation
.
AccountIssue
Un AccountIssue
.
Champs | |
---|---|
name |
Identifiant. Nom de la ressource du problème lié au compte. Format : |
title |
Titre localisé du problème. |
severity |
Gravité globale du problème. |
impacted_ |
Impact de ce problème sur différentes destinations. |
detail |
Informations supplémentaires localisées sur le problème. |
documentation_ |
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 (négatif) de différentes régions sur la destination donnée. |
reporting_ |
Contexte des rapports concerné. |
Impact
Impact du problème sur une région.
Champs | |
---|---|
region_ |
Code de région CLDR auquel le problème s'applique. |
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_ |
Rue dans l'adresse. Exemple : |
city |
Obligatoire. Ville ou commune. Peut également inclure des localités ou sous-localités dépendantes (par exemple, des quartiers ou des banlieues). |
administrative_ |
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_ |
Obligatoire. Code postal (par exemple, "94043"). |
region_ |
Obligatoire. Code pays CLDR (par exemple, "US"). |
AutofeedSettings
Collecte d'informations sur les paramètres de l'alimentation automatique.
Champs | |
---|---|
name |
Identifiant. Nom de ressource des paramètres de flux automatique. Format : |
enable_ |
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 |
Uniquement en sortie. Détermine si le marchand peut être inscrit à un flux automatique. |
BusinessDayConfig
Jours ouvrés de l'entrepôt.
Champs | |
---|---|
business_ |
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 |
Identifiant. Nom de ressource de l'identité de l'entreprise. Format : |
promotions_ |
Obligatoire. Indique si les attributs d'identité peuvent être utilisés pour les promotions. |
black_ |
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 |
women_ |
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 |
veteran_ |
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 |
latino_ |
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 |
small_ |
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 |
IdentityAttribute
Toutes les informations liées à un attribut d'identité.
Champs | |
---|---|
identity_ |
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 | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Valeur par défaut indiquant qu'aucune sélection n'a été effectuée. |
PROMOTIONS_CONSENT_GIVEN |
Indique que le titulaire du compte a accepté que son identité professionnelle soit utilisée à des fins promotionnelles. |
PROMOTIONS_CONSENT_DENIED |
Indique que le compte n'a pas autorisé l'utilisation de son identité professionnelle à des fins promotionnelles. |
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 |
Identifiant. Nom de la ressource des informations sur l'établissement. Format: |
address |
Facultatif. Adresse de l'établissement. Seuls les champs |
phone |
Uniquement en sortie. Numéro de téléphone de l'établissement. |
phone_ |
Uniquement en sortie. État de la validation du numéro de téléphone de l'établissement. |
customer_ |
Facultatif. Le service client de l'entreprise. |
korean_ |
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 |
Obligatoire. Nom du tarif du transporteur. Chaque groupe de tarifs doit avoir un nom unique. |
carrier |
Obligatoire. Service de transporteur, tel que |
carrier_ |
Obligatoire. Service de transporteur, tel que |
origin_ |
Obligatoire. Origine de livraison pour ce tarif de transporteur. |
percentage_ |
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, |
flat_ |
Facultatif. Modificateur de frais de port supplémentaire. Peut être négatif. Par exemple, |
ClaimHomepageRequest
Message de requête pour la méthode ClaimHomepage
.
Champs | |
---|---|
name |
Obligatoire. Nom de la page d'accueil à revendiquer. Format : |
overwrite |
Facultatif. Lorsque cette option est définie sur |
CreateAndConfigureAccountRequest
Message de requête pour la méthode CreateAndConfigureAccount
.
Champs | |
---|---|
account |
Obligatoire. Compte à créer. |
users[] |
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[] |
Facultatif. Utilisateurs à ajouter au compte. |
service[] |
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 |
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_ |
Le fournisseur est un agrégateur pour le compte. Charge utile pour le type de service "Agrégation de comptes". |
provider |
Obligatoire. Fournisseur du service. Référence à un compte tel que |
AddUser
Instructions pour ajouter un utilisateur au compte lors de sa création.
Champs | |
---|---|
user_ |
Obligatoire. Adresse e-mail de l'utilisateur (par exemple, |
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 |
Obligatoire. Compte pour lequel créer une région. Format : |
region_ |
Obligatoire. Identifiant de la région, unique pour toutes les régions du même compte. |
region |
Obligatoire. Région à créer. |
CreateUserRequest
Message de requête pour la méthode CreateUser
.
Champs | |
---|---|
parent |
Obligatoire. Nom de la ressource du compte pour lequel un utilisateur sera créé. Format : |
user_ |
Obligatoire. Adresse e-mail de l'utilisateur (par exemple, |
user |
Facultatif. Utilisateur à créer. |
CustomerService
Informations sur le service client
Champs | |
---|---|
uri |
Facultatif. URI du service client. |
email |
Facultatif. Adresse e-mail du service client. |
phone |
Facultatif. Numéro de téléphone du service client. |
CutoffTime
Définition de l'heure limite en jours ouvrés.
Champs | |
---|---|
hour |
Obligatoire. Heure de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même. |
minute |
Obligatoire. Minute de l'heure limite jusqu'à laquelle une commande doit être passée pour être traitée le jour même. |
time_ |
Obligatoire. Identifiant du fuseau horaire, par exemple "Europe/Zurich". |
DeleteAccountRequest
Message de requête pour la méthode DeleteAccount
.
Champs | |
---|---|
name |
Obligatoire. Nom du compte à supprimer. Format : |
force |
Facultatif. Si la valeur est |
DeleteRegionRequest
Message de requête pour la méthode DeleteRegion
.
Champs | |
---|---|
name |
Obligatoire. Nom de la région à supprimer. Format : |
DeleteUserRequest
Message de requête pour la méthode DeleteUser
.
Champs | |
---|---|
name |
Obligatoire. Nom de l'utilisateur à supprimer. Format : Il est également possible de supprimer l'utilisateur correspondant à l'appelant à l'aide de |
DeliveryTime
Temps passé dans les divers aspects, de la commande à la livraison du produit.
Champs | |
---|---|
warehouse_ |
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_ |
Nombre minimal de jours ouvrés passés en acheminement. 0 signifie livraison le jour même, 1, livraison le lendemain. |
max_ |
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 à |
cutoff_ |
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_ |
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_ |
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 à |
transit_ |
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 |
handling_ |
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_ |
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 |
Obligatoire. Nom du programme pour lequel désactiver la participation du compte donné. Format : |
Distance
Rayon de livraison maximal. Cette information n'est requise que pour le type de livraison en magasin.
Champs | |
---|---|
value |
Valeur entière de la distance. |
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 |
Identifiant. Nom de l'élément EmailPreferences. Le point de terminaison n'est compatible qu'avec l'utilisateur authentifié. |
news_ |
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 |
Obligatoire. Nom du programme pour lequel activer la participation pour le compte donné. Format : |
GetAccountRequest
Message de requête pour la méthode GetAccount
.
Champs | |
---|---|
name |
Obligatoire. Nom du compte à récupérer. Format : |
GetAutofeedSettingsRequest
Message de requête pour la méthode GetAutofeedSettings
.
Champs | |
---|---|
name |
Obligatoire. Nom de ressource des paramètres de flux automatique. Format : |
GetBusinessIdentityRequest
Message de requête pour la méthode GetBusinessIdentity
.
Champs | |
---|---|
name |
Obligatoire. Nom de ressource de l'identité de l'entreprise. Format : |
GetBusinessInfoRequest
Message de requête pour la méthode GetBusinessInfo
.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource des informations sur l'établissement. Format: |
GetEmailPreferencesRequest
Message de requête pour la méthode GetEmailPreferences.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource |
GetHomepageRequest
Message de requête pour la méthode GetHomepage
.
Champs | |
---|---|
name |
Obligatoire. Nom de la page d'accueil à récupérer. Format : |
GetOnlineReturnPolicyRequest
Message de requête pour la méthode GetOnlineReturnPolicy
.
Champs | |
---|---|
name |
Obligatoire. Nom des conditions de retour à récupérer. Format : |
GetProgramRequest
Message de requête pour la méthode GetProgram.
Champs | |
---|---|
name |
Obligatoire. Nom du programme à récupérer. Format : |
GetRegionRequest
Message de requête pour la méthode GetRegion
.
Champs | |
---|---|
name |
Obligatoire. Nom de la région à récupérer. Format : |
GetShippingSettingsRequest
Message de requête pour la méthode GetShippingSetting
.
Champs | |
---|---|
name |
Obligatoire. Nom du paramètre de livraison à récupérer. Format : |
GetTermsOfServiceAgreementStateRequest
Message de requête pour la méthode GetTermsOfServiceAgreementState
.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource de la version des conditions d'utilisation. Format: |
GetTermsOfServiceRequest
Message de requête pour la méthode GetTermsOfService
.
Champs | |
---|---|
name |
Obligatoire. Nom de la ressource de la version des conditions d'utilisation. Format : |
GetUserRequest
Message de requête pour la méthode GetUser
.
Champs | |
---|---|
name |
Obligatoire. Nom de l'utilisateur à récupérer. Format : Il est également possible de récupérer l'utilisateur correspondant à l'appelant à l'aide de |
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[] |
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, |
weights[] |
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, |
number_ |
Obligatoire. Liste d'un nombre inclusif de limites supérieures d'articles. La dernière valeur peut être |
postal_ |
Obligatoire. Liste de noms de groupes postaux. La dernière valeur peut être |
locations[] |
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 |
Identifiant. Nom de la ressource de la page d'accueil du magasin. Format : |
claimed |
Uniquement en sortie. Indique si la page d'accueil est revendiquée. Consultez la page https://support.google.com/merchants/answer/176793. |
uri |
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 |
Obligatoire. Compte dans lequel ce produit sera inséré. Format: accounts/{account} |
shipping_ |
Obligatoire. Nouvelle version du compte. |
ListAccountIssuesRequest
Message de requête pour la méthode ListAccountIssues
.
Champs | |
---|---|
parent |
Obligatoire. Élément parent qui possède cette collection de problèmes. Format : |
page_ |
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_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
language_ |
Facultatif. Les problèmes de la réponse comporteront des champs lisibles dans la langue donnée. Le format est BCP-47, par exemple |
time_ |
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_ |
Problèmes du compte spécifié. |
next_ |
Jeton pouvant être envoyé en tant que |
ListAccountsRequest
Message de requête pour la méthode ListAccounts
.
Champs | |
---|---|
page_ |
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_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
filter |
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[] |
Comptes correspondant à l' |
next_ |
Jeton pouvant être envoyé en tant que |
ListOnlineReturnPoliciesRequest
Message de requête pour la méthode ListOnlineReturnPolicies
.
Champs | |
---|---|
parent |
Obligatoire. Compte marchand pour lequel vous souhaitez afficher les conditions de retour. Format : |
page_ |
Facultatif. Nombre maximal de ressources |
page_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListOnlineReturnPoliciesResponse
Message de réponse pour la méthode ListOnlineReturnPolicies
.
Champs | |
---|---|
online_ |
Conditions de retour récupérées. |
next_ |
Jeton pouvant être envoyé en tant que |
ListProgramsRequest
Message de requête pour la méthode ListPrograms.
Champs | |
---|---|
parent |
Obligatoire. Nom du compte pour lequel tous les programmes doivent être récupérés. Format : |
page_ |
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_ |
Facultatif. Jeton de continuation reçu d'un appel |
ListProgramsResponse
Message de réponse pour la méthode ListPrograms.
Champs | |
---|---|
programs[] |
Programmes du compte donné. |
next_ |
Jeton pouvant être envoyé en tant que |
ListRegionsRequest
Message de requête pour la méthode ListRegions
.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel lister les régions. Format : |
page_ |
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_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListRegionsResponse
Message de réponse pour la méthode ListRegions
.
Champs | |
---|---|
regions[] |
Régions du marchand spécifié. |
next_ |
Jeton pouvant être envoyé en tant que |
ListSubAccountsRequest
Message de requête pour la méthode ListSubAccounts
.
Champs | |
---|---|
provider |
Obligatoire. Fournisseur de services d'agrégation. Format : |
page_ |
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_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListSubAccountsResponse
Message de réponse pour la méthode ListSubAccounts
.
Champs | |
---|---|
accounts[] |
Comptes pour lesquels le compte parent donné est un agrégateur. |
next_ |
Jeton pouvant être envoyé en tant que |
ListUsersRequest
Message de requête pour la méthode ListUsers
.
Champs | |
---|---|
parent |
Obligatoire. Élément parent qui possède cette collection d'utilisateurs. Format : |
page_ |
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_ |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
ListUsersResponse
Message de réponse pour la méthode ListUsers
.
Champs | |
---|---|
users[] |
Utilisateurs du compte spécifié. |
next_ |
Jeton pouvant être envoyé en tant que |
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_ |
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_ |
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_ |
Facultatif. Liste de codes de magasin uniques ou vide pour la valeur par défaut. |
value |
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 |
Identifiant. Nom de la ressource |
return_ |
Uniquement en sortie. ID de conditions de retour généré par Google. |
label |
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[] |
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 |
Conditions de retour. |
seasonal_ |
Facultatif. Remplacements de la règle générale pour les commandes passées pendant un ensemble spécifique d'intervalles de temps. |
restocking_ |
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_ |
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_ |
Les conditions d'acceptation des retours ne doivent pas être vides, sauf si le type de conditions de retour est "noReturns". |
return_ |
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_ |
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_ |
Ce champ indique si le marchand n'accepte les retours que pour les produits défectueux. Il est obligatoire. |
process_ |
Ce champ facultatif indique le nombre de jours nécessaires aux marchands pour traiter les remboursements. |
accept_ |
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 de règle. |
days |
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 |
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
|
|
fixed_ |
Frais de remise en stock fixes. |
micro_ |
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 |
Obligatoire. Type de frais de port de retour. |
fixed_ |
Montant fixe des frais de port de retour. Cette valeur ne s'applique que lorsque le type est |
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 |
Obligatoire. Nom à afficher de ce forçage saisonnier dans Merchant Center. |
begin |
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 |
Obligatoire. Date de fin de l'exception saisonnière (incluse). |
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 |
Identifiant. Nom de ressource du programme. Format : |
documentation_ |
Uniquement en sortie. URL d'une page d'aide Merchant Center décrivant le programme. |
state |
Uniquement en sortie. État de participation du compte au programme. |
active_ |
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 |
unmet_ |
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 |
Uniquement en sortie. Nom de l'exigence. |
documentation_ |
Uniquement en sortie. URL d'une page d'aide décrivant l'exigence. |
affected_ |
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 |
É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_ |
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[] |
Facultatif. Liste de sous-tableaux référencés par |
carrier_ |
Facultatif. Liste des tarifs de transporteurs que |
single_ |
Valeur du groupe de tarifs (par exemple, taux fixe de 10 €). Ne peut être défini que si |
main_ |
Un tableau définissant le groupe de tarifs, lorsque |
name |
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 |
Identifiant. Nom de la ressource de la région. Format : |
postal_ |
Facultatif. Liste des codes postaux qui définissent la région. |
geotarget_ |
Facultatif. Liste des zones géographiques qui définissent la région. |
regional_ |
Uniquement en sortie. Indique si la région peut être utilisée dans la configuration de l'inventaire régional. |
shipping_ |
Uniquement en sortie. Indique si la région peut être utilisée dans la configuration des services de livraison. |
display_ |
Facultatif. Nom à afficher de la région. |
GeoTargetArea
Liste des zones géographiques qui définissent la région.
Champs | |
---|---|
geotarget_ |
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_ |
Obligatoire. Code territoire CLDR ou pays auquel s'applique le groupe de codes postaux. |
postal_ |
Obligatoire. Plage de codes postaux. |
PostalCodeRange
Plage de codes postaux qui définit la zone de la région.
Champs | |
---|---|
begin |
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: |
end |
Facultatif. Code postal ou modèle de |
Obligatoire
Décrit les conditions d'utilisation qui doivent être acceptées.
Champs | |
---|---|
terms_ |
Les termsOfService à accepter. |
tos_ |
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 |
Obligatoire. Compte pour lequel obtenir un format TermsOfServiceAgreementState: |
RetrieveLatestTermsOfServiceRequest
Message de requête pour la méthode RetrieveLatestTermsOfService
.
Champs | |
---|---|
region_ |
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 |
Obligatoire. Type auquel cette version des conditions d'utilisation s'applique. |
Ligne
Incluez une liste de cellules.
Champs | |
---|---|
cells[] |
Obligatoire. Liste des cellules qui constituent la ligne. Doit avoir la même longueur que |
Service
Service de livraison.
Champs | |
---|---|
delivery_ |
Obligatoire. Code CLDR des pays auxquels le service s'applique. |
rate_ |
Facultatif. Définitions des groupes de frais de port. Seul le dernier est autorisé à avoir |
loyalty_ |
Facultatif. Programmes de fidélité auxquels ce service de livraison est limité. |
service_ |
Obligatoire. Nom libre du service. Doit être unique dans le compte cible. |
active |
Obligatoire. Un booléen indiquant l'état actif du service de livraison. |
currency_ |
Code CLDR de la devise à laquelle ce service s'applique. Il doit correspondre à celui des prix dans les groupes de taux. |
delivery_ |
Obligatoire. Temps passé dans les divers aspects, de la commande à la livraison du produit. |
shipment_ |
Type de lieux vers lesquels ce service expédie les commandes. |
minimum_ |
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_ |
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_ |
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_ |
Facultatif. Niveau du programme de fidélité de ce service de livraison. |
program_ |
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_ |
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_ |
Facultatif. Liste des codes de magasins proposant la livraison locale. Si le champ est vide, |
store_ |
Indique si tous les magasins ou certains d'entre eux listés par ce marchand proposent la livraison locale. |
cutoff_ |
Les configurations liées à la livraison locale expirent pour la journée. |
service_ |
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_ |
Heure de fin de la livraison locale pour la journée. |
store_ |
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 |
no_ |
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 |
LocalCutoffTime
Heure de fin de la livraison locale pour la journée.
Champs | |
---|---|
hour |
Heure limite à laquelle les commandes de livraison locale doivent être passées pour être traitées le même jour. |
minute |
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 |
Identifiant. Nom de ressource du paramètre de livraison. Format : |
services[] |
Facultatif. La liste des services du compte cible. |
warehouses[] |
Facultatif. Liste des entrepôts auxquels vous pouvez faire référence dans |
etag |
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 :
|
Table
Un tableau définissant le groupe de tarifs, lorsque single_value
n'est pas assez parlant.
Champs | |
---|---|
rows[] |
Obligatoire. Liste des lignes qui constituent le tableau. Doit avoir la même longueur que |
name |
Nom de la table. Obligatoire pour les sous-tableaux, ignoré pour le tableau principal. |
row_ |
Obligatoire. En-têtes des lignes du tableau. |
column_ |
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 |
Identifiant. Nom de la ressource de la version des conditions d'utilisation. Format : |
region_ |
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 |
kind |
Type auquel cette version des conditions d'utilisation s'applique. |
external |
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 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 |
Identifiant. Nom de la ressource de la version des conditions d'utilisation. Format: |
region_ |
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_ |
Type de conditions d'utilisation associé à la version en question. |
accepted |
Conditions d'utilisation acceptées de ce type et pour le code de région associé |
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_ |
Obligatoire. Liste des noms de régions |
transit_ |
Obligatoire. Liste des libellés de délai d'acheminement. La dernière valeur peut être |
rows[] |
Obligatoire. Si un seul ensemble de dimensions |
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[] |
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_ |
Plage de durée d'acheminement minimale en jours ouvrés. 0 signifie livraison le jour même, 1, livraison le lendemain. |
max_ |
Doit être supérieur ou égal à |
UnclaimHomepageRequest
Message de requête pour la méthode UnclaimHomepage
.
Champs | |
---|---|
name |
Obligatoire. Nom de la page d'accueil à abandonner. Format : |
UpdateAccountRequest
Message de requête pour la méthode UpdateAccount
.
Champs | |
---|---|
account |
Obligatoire. Nouvelle version du compte. |
update_ |
Facultatif. Liste des champs mis à jour. Les champs suivants sont acceptés (dans
|
UpdateAutofeedSettingsRequest
Message de requête pour la méthode UpdateAutofeedSettings
.
Champs | |
---|---|
autofeed_ |
Obligatoire. Nouvelle version du paramètre de flux automatique. |
update_ |
Obligatoire. Liste des champs mis à jour. |
UpdateBusinessIdentityRequest
Message de requête pour la méthode UpdateBusinessIdentity
.
Champs | |
---|---|
business_ |
Obligatoire. Nouvelle version de l'identité de l'entreprise. |
update_ |
Facultatif. Liste des champs mis à jour. Les champs suivants sont acceptés (dans
|
UpdateBusinessInfoRequest
Message de requête pour la méthode UpdateBusinessInfo
.
Champs | |
---|---|
business_ |
Obligatoire. Nouvelle version des informations sur l'établissement. |
update_ |
Facultatif. Liste des champs mis à jour. Les champs suivants sont acceptés (dans
|
UpdateEmailPreferencesRequest
Message de requête pour la méthode UpdateEmailPreferences.
Champs | |
---|---|
email_ |
Obligatoire. Préférences relatives aux e-mails à mettre à jour. |
update_ |
Obligatoire. Liste des champs mis à jour. Les champs suivants sont acceptés (dans
|
UpdateHomepageRequest
Message de requête pour la méthode UpdateHomepage
.
Champs | |
---|---|
homepage |
Obligatoire. Nouvelle version de la page d'accueil. |
update_ |
Facultatif. Liste des champs mis à jour. Les champs suivants sont acceptés (dans
|
UpdateRegionRequest
Message de requête pour la méthode UpdateRegion
.
Champs | |
---|---|
region |
Obligatoire. Région mise à jour. |
update_ |
Facultatif. Masque de champ séparé par une virgule indiquant les champs à mettre à jour. Exemple : |
UpdateUserRequest
Message de requête pour la méthode UpdateUser
.
Champs | |
---|---|
user |
Obligatoire. Nouvelle version de l'utilisateur. Utilisez |
update_ |
Facultatif. Liste des champs mis à jour. Les champs suivants sont acceptés (à la fois dans
|
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 |
Identifiant. Nom de la ressource de l'utilisateur. Format : Utilisez |
state |
Uniquement en sortie. État de l'utilisateur. |
access_ |
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_ |
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_ |
Un tarif fixe. Ne peut être défini que si aucun autre champ n'est défini. |
price_ |
Pourcentage du prix représenté sous la forme d'un nombre en notation décimale (par exemple, |
carrier_ |
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 |
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 |
Obligatoire. Nom de l'entrepôt. Doit être unique dans le compte. |
shipping_ |
Obligatoire. Adresse de livraison de l'entrepôt. |
cutoff_ |
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_ |
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_ |
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 |
Obligatoire. Transporteur, tel que |
carrier_ |
Obligatoire. Service de transporteur, tel que |
warehouse |
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 |
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 |
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. |