Index
AccountIssueService
(interface)AccountsService
(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)AccountIssue
(message)AccountIssue.ImpactedDestination
(message)AccountIssue.ImpactedDestination.Impact
(message)AccountIssue.Severity
(enum)Address
(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.AcceptTermsOfService
(message)CreateAndConfigureAccountRequest.AddAccountService
(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)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)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)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 compatible avec l'API Accounts.
CreateAndConfigureAccount |
---|
Crée un compte Merchant Center autonome avec une configuration supplémentaire. Ajoute l'utilisateur qui effectue la demande en tant qu'administrateur du nouveau compte.
|
DeleteAccount |
---|
Supprime le compte spécifié quel que soit son type: compte individuel, MC ou sous-compte. La suppression d'un MC entraîne la suppression de tous ses sous-comptes. L'exécution de cette méthode nécessite un accès administrateur.
|
GetAccount |
---|
Récupère un compte de votre compte Merchant Center. Une fois que vous avez inséré, mis à jour ou supprimé un compte, plusieurs minutes peuvent s'écouler avant que les modifications ne soient prises en compte.
|
ListAccounts |
---|
Liste les comptes accessibles à l'utilisateur appelant et correspondant aux contraintes de la requête, telles que la taille de la page ou les filtres. Il ne s'agit pas seulement de lister les sous-comptes d'un MC, mais tous les comptes auxquels l'utilisateur appelant a accès, y compris d'autres multicomptes, des comptes associés, des comptes individuels, etc.
|
ListSubAccounts |
---|
Permet de répertorier tous les sous-comptes d'un multicompte donné. Il s'agit d'un wrapper de commodité 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.
|
BusinessIdentityService
Service compatible avec l'API Business Identity.
GetBusinessIdentity |
---|
Récupère l'identité d'entreprise d'un compte.
|
UpdateBusinessIdentity |
---|
Met à jour l'identité d'entreprise d'un compte. L'exécution de cette méthode nécessite un accès administrateur.
|
BusinessInfoService
Service compatible avec l'API Business Info.
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
.
Ce service permet uniquement de récupérer et de mettre à jour les préférences relatives aux e-mails de l'utilisateur authentifié.
GetEmailPreferences |
---|
Affiche les préférences relatives aux e-mails d'un utilisateur de compte Merchant Center. Utilisez l'alias name=accounts/*/users/me/emailPreferences pour obtenir les préférences de l'utilisateur authentifié.
|
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 MC plutôt que celui d'un sous-compte du MC. Les préférences qui ne sont pas explicitement sélectionnées dans le masque de mise à jour ne sont pas mises à jour. La spécification d'une valeur d'état d'activation NON CONFIRMÉE n'est pas valide pour les mises à jour. Utilisez l'alias name=accounts/*/users/me/emailPreferences pour mettre à jour les préférences de l'utilisateur authentifié.
|
HomepageService
Service permettant d'utiliser une API pour la page d'accueil d'un magasin.
ClaimHomepage |
---|
Revend la page d'accueil d'une boutique. L'exécution de cette méthode nécessite un accès administrateur. Si la page d'accueil a déjà été revendiquée, une nouvelle vérification de la validation sera effectuée (sauf si le marchand est exempté de la revendication, ce qui dispense également la validation) et renvoie une réponse valide. Si la propriété ne peut plus être validée, une erreur s'affiche, mais la revendication ne sera pas effacée. En cas d'échec, le message d'erreur canonique suivant s'affiche: * PERMISSION_DENIED: user doesn't have the required permissions on this MC account; * FAILED_PRECONDITION: - Le compte n'est pas un compte Merchant Center. - Le compte Merchant Center n'a pas de page d'accueil. - Échec de la revendication (dans ce cas, le message d'erreur contiendra plus de détails).
|
GetHomepage |
---|
Récupère la page d'accueil d'un magasin.
|
UnclaimHomepage |
---|
Ne revendique pas 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 d'un marchand en cas de rétractation, en incluant les conditions de retour pour les annonces et les fiches gratuites.
programmes. Cette API définit le modèle de ressources suivant:
[OnlineReturnPolicy][google.shopping.merchant.accounts.v1.OnlineReturnPolicy]
GetOnlineReturnPolicy |
---|
Récupère les conditions de retour existantes.
|
ListOnlineReturnPolicies |
---|
Liste toutes les conditions de retour existantes.
|
ProgramsService
Service de gestion de programmes.
Ces programmes permettent d'ajouter des fonctionnalités aux comptes marchands. Le programme Fiches produit sans frais en est un exemple typique. Il permet aux produits d'un marchand d'apparaître sans frais sur Google.
Ce service propose des méthodes permettant de récupérer la participation d'un marchand à tous les programmes disponibles, ainsi que des méthodes permettant d'activer ou de désactiver explicitement sa participation à chaque programme.
DisableProgram |
---|
Désactiver la participation au programme spécifié pour le compte. L'exécution de cette méthode nécessite un accès administrateur.
|
EnableProgram |
---|
Autoriser la participation du compte au programme spécifié. 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 ressources suivant:
Region
CreateRegion |
---|
Crée une 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 |
---|
Liste les régions dans 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 API Merchant Center.
GetShippingSettings |
---|
Récupérez les informations sur les paramètres de livraison.
|
InsertShippingSettings |
---|
Remplacez le paramètre de livraison d'un marchand par celui de la demande. L'exécution de cette méthode nécessite un accès administrateur.
|
TermsOfServiceAgreementStateService
Service compatible avec l'API TermsOfServiceAgreementState
.
GetTermsOfServiceAgreementState |
---|
Affiche 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 d'assurer la compatibilité avec 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 de compte Merchant Center. L'exécution de cette méthode nécessite un accès administrateur.
|
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 de 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 ressource de la version des conditions d'utilisation. Format : |
account |
Obligatoire. Compte pour lequel vous devez accepter les conditions d'utilisation. |
region_code |
Obligatoire. Code de région tel que défini par le CLDR. Il peut s'agir d'un pays dans lequel les conditions d'utilisation s'appliquent spécifiquement ou du nombre 001 lorsqu'elles s'appliquent à l'échelle mondiale. |
Accepté
Décrit les conditions d'utilisation acceptées.
Champs | |
---|---|
terms_of_service |
|
accepted_by |
Compte dans lequel l'acceptation a été enregistrée. Il peut s'agir du compte lui-même ou, dans le cas de sous-comptes, du MC. |
valid_until |
Lorsqu'elle est définie, elle indique que les TermsOfService acceptées ne sont valides que jusqu'à la fin de cette date (indiquée en temps UTC). Vous devrez en accepter un nouveau avant cette date. Les informations sur les TermsOfService obligatoires figurent dans le message Required. |
AccessRight
Le droit d'accès.
Enums | |
---|---|
ACCESS_RIGHT_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
STANDARD |
Droits d'accès standards. |
ADMIN |
Droits d'accès administrateur. |
PERFORMANCE_REPORTING |
Les utilisateurs disposant de ce droit ont accès aux performances et aux insights. |
Compte
Un compte.
Champs | |
---|---|
name |
Identifiant. Nom de ressource du compte. Format : |
account_id |
Uniquement en sortie. Numéro du compte. |
account_name |
Obligatoire. Nom lisible du compte. Pour en savoir plus, consultez les articles sur le nom du magasin et le nom de l'entreprise. |
adult_content |
Indique si ce compte inclut du contenu réservé aux adultes. |
test_account |
Uniquement en sortie. S'il s'agit d'un compte de test. |
time_zone |
Obligatoire. Fuseau horaire du compte En écriture, Pour les lectures, |
language_code |
Obligatoire. Le code de langue BCP-47 du compte ( |
AccountIssue
Un AccountIssue
.
Champs | |
---|---|
name |
Identifiant. Nom de ressource du problème lié au compte. Format : |
title |
Titre localisé du numéro. |
severity |
Gravité globale du problème |
impacted_destinations[] |
L'impact de ce problème sur différentes destinations. |
detail |
Plus d'informations localisées sur le problème. |
documentation_uri |
Lien vers le centre d'aide Merchant Center fournissant des informations supplémentaires sur le problème et sa résolution. |
ImpactedDestination
L'impact du problème sur une destination.
Champs | |
---|---|
impacts[] |
L'impact (négatif) pour différentes régions sur la destination donnée. |
reporting_context |
Le contexte de reporting concerné |
Impact
L'impact du problème sur une région.
Champs | |
---|---|
region_code |
Code CLDR dans lequel ce problème s'applique. |
severity |
Gravité du problème au niveau de la destination et de la région. |
Gravité
Tous les niveaux de gravité possibles.
Enums | |
---|---|
SEVERITY_UNSPECIFIED |
La gravité est inconnue. |
CRITICAL |
Ce problème empêche la diffusion des offres. |
ERROR |
Le problème peut avoir une incidence sur les offres (à l'avenir) ou indiquer des problèmes liés aux offres. |
SUGGESTION |
Le problème est une suggestion d'amélioration. |
Adresse
Adresse de livraison de l'entrepôt.
Champs | |
---|---|
street_address |
Partie de l'adresse située au niveau de la rue. 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_area |
Obligatoire. Subdivision administrative de niveau supérieur du pays. Par exemple, un État comme la Californie ("CA") ou une province comme le Québec ("QC"). |
postal_code |
Obligatoire. Code postal (par exemple, "94043"). |
region_code |
Obligatoire. Code pays CLDR (par exemple, "US"). |
BusinessDayConfig
Jours ouvrés de l'entrepôt.
Champs | |
---|---|
business_days[] |
Obligatoire. Jours ouvrés normaux. Ne peut pas être vide. |
Jour de la semaine
Enums | |
---|---|
WEEKDAY_UNSPECIFIED |
|
MONDAY |
|
TUESDAY |
|
WEDNESDAY |
|
THURSDAY |
|
FRIDAY |
|
SATURDAY |
|
SUNDAY |
BusinessIdentity
Collecte d'informations en lien avec l'identité d'une entreprise.
Champs | |
---|---|
name |
Identifiant. Nom de ressource de l'identité de l'entreprise. Format : |
promotions_consent |
Facultatif. Indique si les attributs d'identité peuvent être utilisés pour des promotions. |
black_owned |
Facultatif. Indique si l'établissement s'identifie comme détenu par un noir. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur |
women_owned |
Facultatif. Indique si l'établissement est détenu par une femme. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur |
veteran_owned |
Facultatif. Indique si l'établissement est détenu par un vétéran. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur |
latino_owned |
Facultatif. Indique si l'établissement s'identifie comme détenu par un groupe latino-américain. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur |
small_business |
Facultatif. Indique si l'établissement s'identifie comme une petite entreprise. Ce champ facultatif n'est disponible que pour les marchands dont le pays d'activité est défini sur |
IdentityAttribute
Toutes les informations liées à un attribut d'identité.
Champs | |
---|---|
identity_declaration |
Obligatoire. Déclaration d'identité pour cet attribut. |
IdentityDeclaration
Tous les paramètres possibles concernant la déclaration d'identité.
Enums | |
---|---|
IDENTITY_DECLARATION_UNSPECIFIED |
Valeur par défaut indiquant qu'aucune sélection n'a été effectuée. |
SELF_IDENTIFIES_AS |
Indique que le compte s'identifie à l'attribut. |
DOES_NOT_SELF_IDENTIFY_AS |
Indique que le compte ne s'identifie pas à l'attribut. |
PromotionsConsent
Tous les paramètres possibles concernant les promotions liées à l'identité de l'entreprise.
Enums | |
---|---|
PROMOTIONS_CONSENT_UNSPECIFIED |
Valeur par défaut indiquant qu'aucune sélection n'a été effectuée. |
PROMOTIONS_CONSENT_GIVEN |
Indique que le compte a accepté que l'identité de son entreprise soit utilisée pour des promotions. |
PROMOTIONS_CONSENT_DENIED |
Indique que le compte n'a pas autorisé l'utilisation de l'identité de son entreprise pour les promotions. |
BusinessInfo
Collecte d'informations sur un établissement.
Champs | |
---|---|
name |
Identifiant. Nom de ressource des informations sur l'établissement. Format: |
address |
Facultatif. Adresse de l'établissement. |
phone |
Uniquement en sortie. Numéro de téléphone de l'établissement. |
phone_verification_state |
Uniquement en sortie. État de validation du numéro de téléphone de l'établissement. |
customer_service |
Facultatif. Le service client de l'établissement. |
korean_business_registration_number |
Facultatif. Numéro d'enregistrement d'entreprise coréen à 10 chiffres, séparés par des tirets, au format suivant: XXX-XX-XXXXX. |
CarrierRate
Liste des tarifs de transporteurs auxquels les main_table
ou single_value
peuvent faire référence.
Champs | |
---|---|
name |
Obligatoire. Nom du tarif du transporteur. Doit être unique pour chaque groupe de tarifs. |
carrier |
Obligatoire. Service de transporteur, tel que |
carrier_service |
Obligatoire. Service de transporteur, tel que |
origin_postal_code |
Obligatoire. Lieu de livraison pour ce tarif de transporteur. |
percentage_adjustment |
Facultatif. Multiplicateur du modificateur des frais de port sous forme de nombre en notation décimale. Peut être négatif. Par exemple, |
flat_adjustment |
Facultatif. Modificateur supplémentaire des frais de port. 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 : |
CreateAndConfigureAccountRequest
Message de requête pour la méthode CreateAndConfigureAccount
.
Champs | |
---|---|
account |
Obligatoire. Compte à créer. |
users[] |
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 l'un de ces services. Actuellement, seul |
accept_terms_of_service |
Facultatif. Les conditions d'utilisation doivent être acceptées dès la création d'un compte. |
AcceptTermsOfService
Référence à une ressource de conditions d'utilisation.
Champs | |
---|---|
name |
Obligatoire. Nom de ressource de la version des conditions d'utilisation. |
region_code |
Obligatoire. Code de région tel que défini par le CLDR. Il peut s'agir d'un pays où les conditions d'utilisation s'appliquent spécifiquement ou de |
AddAccountService
Instructions supplémentaires pour ajouter des services lors de la création du compte
Champs | |
---|---|
Champ d'union service_type . Actuellement, seul le type de compte parent multiclient est accepté. La service_type ne peut être qu'un des éléments suivants : |
|
account_aggregation |
Le fournisseur est un agrégateur pour le compte. |
provider |
Facultatif. Fournisseur du service. Format : |
CreateRegionRequest
Message de requête pour la méthode CreateRegion
.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel créer une région. Format : |
region_id |
Obligatoire. Identifiant de la région, unique dans toutes les régions d'un même compte. |
region |
Obligatoire. Région à créer. |
CreateUserRequest
Message de requête pour la méthode CreateUser
.
Champs | |
---|---|
parent |
Obligatoire. Nom de ressource du compte pour lequel un utilisateur sera créé. Format : |
user_id |
Obligatoire. Adresse e-mail de l'utilisateur (par exemple, |
user |
Obligatoire. Utilisateur à créer. |
CustomerService
Informations sur le service client
Champs | |
---|---|
uri |
Facultatif. URI où se trouve le service client. |
email |
Facultatif. Adresse e-mail à laquelle le service client peut être contacté. |
phone |
Facultatif. Numéro de téléphone auquel le service client peut être appelé. |
CutoffTime
Définition de l'heure limite pour les jours ouvrés.
Champs | |
---|---|
hour |
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_zone |
Obligatoire. Identifiant de fuseau horaire : par exemple, "Europe/Zurich". |
DeleteAccountRequest
Message de requête pour la méthode DeleteAccount
.
Champs | |
---|---|
name |
Obligatoire. Nom du compte à supprimer. Format : |
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 en utilisant |
DeliveryTime
Temps consacré à divers aspects, de la commande à la livraison du produit.
Champs | |
---|---|
warehouse_based_delivery_times[] |
Facultatif. Indique que le délai de livraison doit être calculé pour chaque entrepôt (adresse d'origine de l'expédition) en fonction des paramètres du transporteur sélectionné. Lorsque cette option est définie, aucun autre champ lié au délai d'acheminement dans [delivery time][[google.shopping.content.bundles.ShippingSetting.DeliveryTime]] ne doit être défini. |
min_transit_days |
Nombre minimal de jours ouvrés passés en acheminement. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain. Vous devez définir |
max_transit_days |
Nombre maximal de jours ouvrés passés en acheminement. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain. La valeur doit être supérieure ou égale à |
cutoff_time |
Définition de l'heure limite pour les jours ouvrés. Si elle n'est pas configurée, l'heure limite sera définie par défaut sur 8h PST. |
min_handling_days |
Nombre minimal de jours ouvrés dépensés avant l'expédition d'une commande. La valeur 0 correspond à la livraison le jour même, et la valeur 1 à la livraison le lendemain. |
max_handling_days |
Nombre maximal de jours ouvrés dépensés avant l'expédition d'une commande. La valeur 0 correspond à la livraison le jour même, et la valeur 1 à la livraison le lendemain. La valeur doit être supérieure ou égale à |
transit_time_table |
Tableau du délai d'acheminement, nombre de jours ouvrés passés en transit en fonction des dimensions des lignes et des colonnes. Vous pouvez définir |
handling_business_day_config |
Jours ouvrés pendant lesquels les commandes peuvent être traitées. Si aucune valeur n'est fournie, le système considère que les jours ouvrés sont du lundi au vendredi. |
transit_business_day_config |
Jours ouvrés pendant lesquels les commandes peuvent être en transit. Si aucune valeur n'est fournie, le système considère que les jours ouvrés sont du lundi au vendredi. |
DisableProgramRequest
Message de requête pour la méthode DisableProgram.
Champs | |
---|---|
name |
Obligatoire. Nom du programme auquel le compte donné doit désactiver la participation. Format : |
Distance
Rayon de livraison maximal Cette valeur n'est obligatoire que pour le type de livraison en magasin.
Champs | |
---|---|
value |
Distance (nombre entier). |
unit |
L'unité peut varier en fonction du pays. Elle est paramétrée pour inclure les miles et les kilomètres. |
Unité
L'unité peut varier en fonction du pays. Elle est paramétrée pour inclure les miles et les kilomètres.
Enums | |
---|---|
UNIT_UNSPECIFIED |
Unité non spécifiée |
MILES |
Unité en miles |
KILOMETERS |
Unité en kilomètres |
EmailPreferences
Catégories de notifications activées / désactivées par l'utilisateur. Les préférences relatives aux e-mails n'incluent pas les annonces obligatoires, car les utilisateurs ne peuvent pas les désactiver.
Champs | |
---|---|
name |
Identifiant. Nom de la ressource EmailPreferences. Le point de terminaison n'est compatible qu'avec l'utilisateur authentifié. |
news_and_tips |
Facultatif. Informations sur les nouvelles fonctionnalités, conseils et bonnes pratiques. |
OptInState
Activer l'état des préférences relatives aux e-mails.
Enums | |
---|---|
OPT_IN_STATE_UNSPECIFIED |
L'état d'activation n'est pas spécifié. |
OPTED_OUT |
L'utilisateur a désactivé la réception de ce type d'e-mail. |
OPTED_IN |
L'utilisateur a accepté de recevoir ce type d'e-mail. |
UNCONFIRMED |
L'utilisateur a accepté de recevoir ce type d'e-mail et l'e-mail de confirmation a été envoyé, mais l'utilisateur n'a pas encore confirmé l'activation (s'applique uniquement à certains pays). |
EnableProgramRequest
Message de requête pour la méthode EnableProgram.
Champs | |
---|---|
name |
Obligatoire. Nom du programme auquel le compte donné doit autoriser la participation. Format : |
GetAccountRequest
Message de requête pour la méthode GetAccount
.
Champs | |
---|---|
name |
Obligatoire. Nom du compte à récupérer. 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 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 ressource de la version des conditions d'utilisation. Format: |
GetTermsOfServiceRequest
Message de requête pour la méthode GetTermsOfService
.
Champs | |
---|---|
name |
Obligatoire. Nom de 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 en utilisant |
En-têtes
Liste non vide d'en-têtes de ligne ou de colonne pour un tableau. Vous ne devez définir qu'une seule des propriétés suivantes : prices
, weights
, num_items
, postal_code_group_names
ou location
.
Champs | |
---|---|
prices[] |
Obligatoire. Liste de limites supérieures de prix de commande inclus. La valeur du dernier prix peut être infinie en définissant "price amount_micros" sur -1. Par exemple, |
weights[] |
Obligatoire. Liste de limites supérieures inclusives de poids de commande. La dernière valeur de pondération peut être infinie si vous définissez "price amount_micros" sur -1. Par exemple, |
number_of_items[] |
Obligatoire. Liste de limites supérieures (incluses) d'éléments. La dernière valeur peut être |
postal_code_group_names[] |
Obligatoire. Liste de noms de groupes postaux. La dernière valeur peut être |
locations[] |
Obligatoire. Liste des ensembles d'ID de zones géographiques. Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini. |
Page d'accueil
Page d'accueil d'un magasin
Champs | |
---|---|
name |
Identifiant. Nom de 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 du magasin. |
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_setting |
Obligatoire. Nouvelle version du compte. |
ListAccountIssuesRequest
Message de requête pour la méthode ListAccountIssues
.
Champs | |
---|---|
parent |
Obligatoire. Le parent, qui possède cet ensemble de numéros. Format : |
page_size |
Facultatif. Nombre maximal de numéros à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 utilisateurs au maximum seront renvoyés. La valeur maximale est 100. les valeurs supérieures à 100 sont converties en 100. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
language_code |
Facultatif. Les problèmes dans la réponse comporteront des champs lisibles par l'humain dans la langue donnée. Le format est BCP-47 ( |
time_zone |
Facultatif. Fuseau horaire IANA utilisé pour localiser les heures dans des champs lisibles. Par exemple, "America/Los_Angeles". Si la valeur n'est pas définie, "America/Los_Angeles" sera utilisé. |
ListAccountIssuesResponse
Message de réponse pour la méthode ListAccountIssues
.
Champs | |
---|---|
account_issues[] |
Problèmes du compte spécifié. |
next_page_token |
Jeton pouvant être envoyé en tant que |
ListAccountsRequest
Message de requête pour la méthode ListAccounts
.
Champs | |
---|---|
page_size |
Facultatif. Nombre maximal de comptes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 250 comptes au maximum sont renvoyés. La valeur maximale est 500. les valeurs supérieures à 500 sont converties en 500. |
page_token |
Facultatif. Jeton de page reçu d'un appel Lors de la pagination, tous les autres paramètres fournis à |
filter |
Facultatif. Affiche uniquement les comptes correspondant au filtre. Pour en savoir plus, consultez la documentation de référence sur la syntaxe des filtres. |
ListAccountsResponse
Message de réponse pour la méthode ListAccounts
.
Champs | |
---|---|
accounts[] |
Les comptes correspondant à l' |
next_page_token |
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 lister les conditions de retour. Format : |
page_size |
Facultatif. Nombre maximal de ressources |
page_token |
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_return_policies[] |
Conditions de retour récupérées. |
next_page_token |
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 vous souhaitez récupérer tous les programmes. Format : |
page_size |
Facultatif. Nombre maximal de programmes à renvoyer en une seule réponse. Si aucune valeur n'est spécifiée (ou 0), la taille par défaut utilisée est de 1 000. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
Facultatif. Jeton de continuité, reçu d'un appel |
ListProgramsResponse
Message de réponse pour la méthode ListPrograms.
Champs | |
---|---|
programs[] |
Programmes pour le compte donné. |
next_page_token |
Jeton pouvant être envoyé en tant que |
ListRegionsRequest
Message de requête pour la méthode ListRegions
.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel répertorier les régions. Format : |
page_size |
Facultatif. Nombre maximal de régions à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 régions au maximum seront renvoyées. La valeur maximale est 1 000. Les valeurs supérieures sont réduites à 1 000. |
page_token |
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_page_token |
Jeton pouvant être envoyé en tant que |
ListSubAccountsRequest
Message de requête pour la méthode ListSubAccounts
.
Champs | |
---|---|
provider |
Obligatoire. Le compte parent Format : |
page_size |
Facultatif. Nombre maximal de comptes à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 250 comptes au maximum sont renvoyés. La valeur maximale est 500. les valeurs supérieures à 500 sont converties en 500. |
page_token |
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_page_token |
Jeton pouvant être envoyé en tant que |
ListUsersRequest
Message de requête pour la méthode ListUsers
.
Champs | |
---|---|
parent |
Obligatoire. Le parent, qui possède cette collection d'utilisateurs. Format : |
page_size |
Facultatif. Nombre maximal d'utilisateurs à renvoyer. Le service peut renvoyer un nombre inférieur à cette valeur. Si aucune valeur n'est spécifiée, 50 utilisateurs au maximum seront renvoyés. La valeur maximale est 100. les valeurs supérieures à 100 sont converties en 100. |
page_token |
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_page_token |
Jeton pouvant être envoyé en tant que |
LocationIdSet
Liste des ensembles d'ID de zones géographiques. Ce champ ne doit pas être vide. Ne peut être défini que si aucun autre champ n'est défini.
Champs | |
---|---|
location_ids[] |
Obligatoire. Liste non vide d'ID de zone géographique. Ils doivent tous être du même type d'emplacement (par exemple, un État). |
MinimumOrderValueTable
Tableau des valeurs minimales de commande par magasin pour le type de retrait en magasin.
Champs | |
---|---|
store_code_set_with_movs[] |
Obligatoire. Liste d'ensembles de codes de magasin partageant le même montant minimal de commande. Il doit y avoir au moins deux ensembles et le dernier vide, ce qui signifie "MOV for all other stores". Chaque code de magasin ne peut apparaître qu'une seule fois dans tous les ensembles. Tous les prix d'un service doivent être exprimés dans la même devise. |
StoreCodeSetWithMov
Liste d'ensembles de codes de magasin partageant le même montant minimal de commande. Il doit y avoir au moins deux ensembles et le dernier vide, ce qui signifie "MOV for all other stores". Chaque code de magasin ne peut apparaître qu'une seule fois dans tous les ensembles. Tous les prix d'un service doivent être exprimés dans la même devise.
Champs | |
---|---|
store_codes[] |
Facultatif. Liste de codes de magasin uniques ou vide pour l'alias collecteur. |
value |
Montant minimal de commande des magasins donnés. |
OnlineReturnPolicy
Objet Conditions de retour en ligne. Il sert actuellement à représenter les conditions de retour pour les programmes des annonces et des fiches gratuites.
Champs | |
---|---|
name |
Identifiant. Nom de la ressource |
return_policy_id |
Uniquement en sortie. ID des conditions de retour généré par Google. |
label |
Ce champ représente le libellé unique défini par l'utilisateur des conditions de retour. Il est important de noter que vous ne pouvez pas utiliser la même étiquette dans des conditions de retour différentes pour un même pays. Les règles porteront automatiquement le libellé "par défaut", sauf si un produit spécifie un attribut d'étiquette spécifique. Pour attribuer des conditions de retour personnalisées à certains groupes de produits, suivez les instructions fournies dans le libellé des conditions de retour. Le libellé peut contenir jusqu'à 50 caractères. |
countries[] |
Pays de vente dans lesquels les conditions de retour s'appliquent. Les valeurs doivent être un code ISO 3166 à deux lettres valide. |
policy |
Conditions de retour. |
restocking_fee |
Frais de remise en stock qui s'appliquent à toutes les catégories de motifs de retour. Ces frais sont alors considérés comme des frais de remise en stock sans frais si cette valeur n'est pas définie. |
return_methods[] |
Méthodes de retour utilisées par les clients pour retourner un article. Cette valeur ne doit pas être vide, sauf si le type de conditions de retour est "noReturns". |
item_conditions[] |
Les conditions de retour acceptées pour les articles ne doivent pas être vides, sauf si le type de conditions de retour est défini sur "noReturns". |
return_shipping_fee |
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 |
URI des conditions de retour. Google peut l'utiliser pour effectuer un contrôle de l'intégrité de la règle. L'URL doit être valide. |
accept_defective_only |
Ce champ est obligatoire et permet d'indiquer si le marchand n'accepte que les produits défectueux pour les retours. |
process_refund_days |
Ce champ est facultatif et indique le nombre de jours nécessaires au traitement des remboursements par les marchands. |
accept_exchange |
Ce champ est obligatoire et permet d'indiquer si le marchand autorise les clients à échanger des produits. |
ItemCondition
Conditions de l'article disponible.
Enums | |
---|---|
ITEM_CONDITION_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
NEW |
Des nouveautés |
USED |
Utilisé. |
Règle
Règles disponibles.
Champs | |
---|---|
type |
Type de règle. |
days |
Nombre de jours pendant lesquels les articles peuvent être retournés après leur livraison (un jour correspond à 24 heures après le code temporel de livraison). Obligatoire pour les retours |
Type
Types de conditions de retour.
Enums | |
---|---|
TYPE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
NUMBER_OF_DAYS_AFTER_DELIVERY |
Nombre de jours pendant lesquels un retour est valide après la livraison. |
NO_RETURNS |
Aucun retour. |
LIFETIME_RETURNS |
Un retour à vie. |
RestockingFee
Frais de remise en stock Il peut s'agir d'un tarif forfaitaire ou d'un micro-pourcentage.
Champs | |
---|---|
Champ d'union
|
|
fixed_fee |
Frais de remise en stock fixes. |
micro_percent |
Pourcentage du prix total en micros. 15 000 000 signifie que 15% du prix total seraient facturés. |
ReturnMethod
Méthodes de retour disponibles.
Enums | |
---|---|
RETURN_METHOD_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
BY_MAIL |
À retourner par courrier. |
IN_STORE |
Retour en magasin. |
AT_A_KIOSK |
Revenez sur une borne. |
ReturnShippingFee
Frais de port de retour. Il peut s'agir de frais fixes ou d'une valeur booléenne indiquant que le client paie les frais de port réels.
Champs | |
---|---|
type |
Type de frais de port de retour. |
fixed_fee |
Montant des frais de port de retour fixes. Cette valeur n'est applicable 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. |
PhoneVerificationState
État de validation du numéro de téléphone.
Enums | |
---|---|
PHONE_VERIFICATION_STATE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
PHONE_VERIFICATION_STATE_VERIFIED |
Le numéro de téléphone est validé. |
PHONE_VERIFICATION_STATE_UNVERIFIED |
Le numéro de téléphone n'est pas validé |
Programme
Définit la participation à un programme donné pour le compte spécifié.
Ces programmes permettent d'ajouter des fonctionnalités aux comptes marchands. Le programme Fiches produit sans frais en est un exemple typique. Il permet aux produits d'un marchand d'apparaître sans frais sur Google.
Champs | |
---|---|
name |
Identifiant. Nom de ressource du programme. Format : |
documentation_uri |
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_region_codes[] |
Uniquement en sortie. Régions dans lesquelles le compte participe activement au programme. Les régions actives sont celles où toutes les conditions du programme applicables dans ces régions sont remplies. Les codes de région sont définis par le CLDR. Il peut s'agir d'un pays où le programme s'applique spécifiquement ou de |
unmet_requirements[] |
Uniquement en sortie. Les conditions non encore remplies pour le compte et qui ont une incidence sur la participation au programme |
Exigence
Définit une condition requise pour participer au programme.
Champs | |
---|---|
title |
Uniquement en sortie. Nom de l'exigence. |
documentation_uri |
Uniquement en sortie. URL d'une page d'aide décrivant l'exigence. |
affected_region_codes[] |
Uniquement en sortie. Régions actuellement concernées par cette exigence non respectées. Les codes de région sont définis par le CLDR. Il peut s'agir d'un pays où le programme s'applique spécifiquement ou de |
État
États de participation possibles au programme pour le compte.
Enums | |
---|---|
STATE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
NOT_ELIGIBLE |
Le compte n'est pas autorisé à participer au programme. |
ELIGIBLE |
Le compte est autorisé à participer au programme. |
ENABLED |
Le programme est activé pour le compte. |
RateGroup
Définitions des groupes de tarifs de livraison. Seul le dernier est autorisé à avoir un applicable_shipping_labels
vide, ce qui signifie "tout le reste". L'autre applicable_shipping_labels
ne doit pas se chevaucher.
Champs | |
---|---|
applicable_shipping_labels[] |
Obligatoire. Liste d'étiquettes de livraison définissant les produits auxquels ce groupe de tarifs s'applique. Il s'agit d'une disjonction: une seule étiquette doit correspondre pour que le groupe de tarifs s'applique. Ce champ ne peut être vide que pour le dernier groupe de tarifs d'un service. |
subtables[] |
Facultatif. Liste de sous-tableaux référencés par |
carrier_rates[] |
Facultatif. Liste des tarifs de transporteurs auxquels les |
single_value |
Valeur du groupe de tarifs (par exemple, taux fixe 10 $). Ne peut être défini que si |
main_table |
Un tableau définissant le groupe de tarifs, lorsque |
name |
Facultatif. Nom du groupe de tarifs. S'il est défini, il doit être unique au sein du service de livraison. |
Région
Représente une 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 plus d'informations, consultez Configurer des régions .
Champs | |
---|---|
name |
Identifiant. Nom de ressource de la région. Format : |
postal_code_area |
Facultatif. Liste de codes postaux définissant la région. |
geotarget_area |
Facultatif. Liste de cibles géographiques qui définit la zone de la région. |
regional_inventory_eligible |
Uniquement en sortie. Indique si la région peut être utilisée dans la configuration de l'inventaire régional. |
shipping_eligible |
Uniquement en sortie. Indique si la région peut être utilisée dans la configuration des services de livraison. |
display_name |
Facultatif. Nom à afficher pour la région. |
GeoTargetArea
Liste de cibles géographiques qui définit la zone de la région.
Champs | |
---|---|
geotarget_criteria_ids[] |
Obligatoire. Liste non vide d'ID de zone géographique. Ils doivent tous être du même type d'emplacement (par exemple, un État). |
PostalCodeArea
Liste de codes postaux définissant la région. Remarque: Toutes les régions définies à l'aide de codes postaux sont accessibles via la ressource ShippingSettings.postalCodeGroups
du compte.
Champs | |
---|---|
region_code |
Obligatoire. Code CLDR ou pays auquel le groupe de codes postaux s'applique. |
postal_codes[] |
Obligatoire. Une plage de codes postaux. |
PostalCodeRange
Plage de codes postaux définissant la région.
Champs | |
---|---|
begin |
Obligatoire. Code postal ou format de préfixe* indiquant la limite inférieure inclue de la plage qui définit la zone. Exemples de valeurs: |
end |
Facultatif. Code postal ou modèle de |
Obligatoire
Décrit les conditions d'utilisation devant être acceptées.
Champs | |
---|---|
terms_of_service |
Les conditions d'utilisation (termsOfService) à accepter. |
tos_file_uri |
URL complète du fichier des conditions d'utilisation. Ce champ est le même que TermsOfService.file_uri, mais n'est ajouté ici que pour plus de commodité. |
RetrieveForApplicationTermsOfServiceAgreementStateRequest
Message de requête pour la méthode RetrieveForApplicationTermsOfServiceAgreementState
.
Champs | |
---|---|
parent |
Obligatoire. Compte pour lequel vous souhaitez obtenir un format "TermsOfServiceAgreementState" : |
RetrieveLatestTermsOfServiceRequest
Message de requête pour la méthode RetrieveLatestTermsOfService
.
Champs | |
---|---|
region_code |
Code de région tel que défini par le CLDR. Il peut s'agir d'un pays dans lequel les conditions d'utilisation s'appliquent spécifiquement ou du nombre 001 lorsqu'elles s'appliquent à l'échelle mondiale. |
kind |
Genre auquel s'applique cette version des conditions d'utilisation. |
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_countries[] |
Obligatoire. Code CLDR des pays auxquels le service s'applique. |
rate_groups[] |
Facultatif. Définitions des groupes de tarifs de livraison. Seul le dernier est autorisé à avoir un |
loyalty_programs[] |
Facultatif. Programmes de fidélité auxquels ce service de livraison est limité. |
service_name |
Obligatoire. Nom libre du service. Doit être unique dans le compte cible. |
active |
Obligatoire. Booléen indiquant l'état actif du service de livraison. |
currency_code |
Code CLDR de la devise à laquelle ce service s'applique. Doit correspondre à celui des prix dans les groupes de tarifs. |
delivery_time |
Obligatoire. Temps consacré à divers aspects, de la commande à la livraison du produit. |
shipment_type |
Type de lieu où ce service expédie les commandes. |
minimum_order_value |
Montant minimal de commande pour ce service. Si cet indicateur est défini, il indique que les clients devront dépenser au moins ce montant. Tous les prix d'un service doivent être exprimés dans la même devise. Ne peut pas être défini avec la valeur "minimum_order_value_table". |
minimum_order_value_table |
Tableau des valeurs minimales de commande par magasin pour le type de retrait en magasin. Ne peut pas être défini avec la valeur "minimum_order_value". |
store_config |
Liste des magasins depuis lesquels vos produits sont livrés. Cette valeur n'est valide que pour le type de livraison en magasin. |
LoyaltyProgram
Programme de fidélité proposé par un marchand.
Champs | |
---|---|
loyalty_program_tiers[] |
Facultatif. Niveau du programme de fidélité de ce service de livraison. |
program_label |
Il s'agit du libellé du programme de fidélité défini dans les paramètres de votre programme de fidélité dans Merchant Center. Ce sous-attribut permet à Google de faire correspondre votre programme de fidélité aux offres éligibles. |
LoyaltyProgramTiers
Sous-ensemble du programme de fidélité d'un marchand.
Champs | |
---|---|
tier_label |
Le sous-attribut libellé de niveau [tier_label] permet de distinguer les avantages de chaque niveau. Cette valeur est également définie dans les paramètres de votre programme dans Merchant Center. Elle est obligatoire pour modifier la source de données, même si votre programme de fidélité ne comporte qu'un seul niveau. |
ShipmentType
Type de service de livraison.
Enums | |
---|---|
SHIPMENT_TYPE_UNSPECIFIED |
Aucun type de livraison n'a été spécifié pour ce service. |
DELIVERY |
Ce service expédie les commandes à une adresse choisie par le client. |
LOCAL_DELIVERY |
Ce service expédie les commandes à une adresse choisie par le client. La commande est livrée par un magasin à proximité. |
COLLECTION_POINT |
Ce service expédie les commandes à une adresse choisie par le client. La commande est expédiée depuis un point retrait. |
StoreConfig
Liste des magasins depuis lesquels vos produits sont livrés. Cette valeur n'est valide que pour le type de livraison en magasin.
Champs | |
---|---|
store_codes[] |
Facultatif. Liste des codes de magasin proposant la livraison locale. Si ce champ est vide, |
store_service_type |
Indique si tous les magasins de ce marchand, ou certains d'entre eux, proposent la livraison locale. |
cutoff_config |
Les configurations liées à la livraison locale se terminent pour la journée. |
service_radius |
Rayon de livraison maximal Cette valeur n'est obligatoire que pour le type de livraison en magasin. |
CutoffConfig
Les configurations liées à la livraison locale se terminent pour la journée.
Champs | |
---|---|
local_cutoff_time |
Heure de fin de la livraison locale pour la journée. |
store_close_offset_hours |
Valable uniquement pour la livraison locale. Représente l'heure limite pour commander comme le nombre d'heures avant la fermeture du magasin. Exclusivité mutuelle avec |
no_delivery_post_cutoff |
Les marchands peuvent désactiver l'affichage de la livraison locale n+1 jour lorsqu'ils ont configuré un service de livraison pour la livraison locale en N jours. Par exemple, si le service de livraison définit la livraison le même jour et que la date limite est passée, si vous définissez ce champ sur |
LocalCutoffTime
Heure de fin de la livraison locale pour la journée.
Champs | |
---|---|
hour |
Les commandes avec livraison locale doivent être passées le jour même et traitées le jour même. |
minute |
Les commandes livrées localement doivent être passées d'ici le minute près pour être traitées le jour même. |
StoreServiceType
Indique si tous les magasins, ou certains d'entre eux, listés par le marchand proposent la livraison locale.
Enums | |
---|---|
STORE_SERVICE_TYPE_UNSPECIFIED |
Aucun type de service de magasin spécifié. |
ALL_STORES |
Indique si tous les magasins, actuels et futurs, listés par ce marchand proposent la livraison locale. |
SELECTED_STORES |
Indique que seuls les magasins listés dans store_codes peuvent utiliser la livraison locale. |
ShippingSettings
Le [paramètre de livraison](https://support.google.com/merchants/answer/6069284) du compte marchand.
Champs | |
---|---|
name |
Identifiant. Nom de ressource du paramètre de livraison. Format : |
services[] |
Facultatif. Liste des services du compte cible. |
warehouses[] |
Facultatif. Liste des entrepôts auxquels vous pouvez vous référer dans |
etag |
Obligatoire. Ce champ permet d'éviter les problèmes asynchrones. Assurez-vous que les données des paramètres de livraison n'ont pas changé entre l'appel get et l'insertion de l'appel. L'utilisateur doit procéder comme suit :
|
Tableau
Un tableau définissant le groupe de tarifs, lorsque single_value
n'est pas assez parlant.
Champs | |
---|---|
rows[] |
Obligatoire. Liste des lignes qui constituent la table. Doit avoir la même longueur que |
name |
Nom de la table. Obligatoire pour les sous-tableaux, ignoré pour la table principale. |
row_headers |
Obligatoire. En-têtes des lignes du tableau. |
column_headers |
En-têtes des colonnes du tableau. Facultatif: si ce champ n'est pas défini, le tableau ne comporte qu'une seule dimension. |
TermsOfService
Un TermsOfService
.
Champs | |
---|---|
name |
Identifiant. Nom de ressource de la version des conditions d'utilisation. Format : |
region_code |
Code de région tel que défini par le CLDR. Il peut s'agir d'un pays où les conditions d'utilisation s'appliquent spécifiquement ou |
kind |
Genre auquel s'applique cette version des conditions d'utilisation. |
external |
Indique si cette version des conditions d'utilisation est externe. Les versions externes des conditions d'utilisation ne peuvent être acceptées que par le biais de processus externes, et non directement par le marchand via l'interface utilisateur ou l'API. |
file_uri |
URI du fichier de conditions d'utilisation qui doit être affiché pour les signataires. |
TermsOfServiceAgreementState
Cette ressource représente l'état du contrat pour un compte donné et le type de conditions d'utilisation. L'état est le suivant:
- Si le marchand a accepté des conditions d'utilisation, la valeur accepted est renseignée. Dans les autres cas, la valeur est vide.
- Si le marchand doit signer des conditions d'utilisation, la valeur required est renseignée. Dans le cas contraire, la valeur est vide.
Notez que les attributs obligatoire et accepté peuvent être présents. Dans ce cas, les conditions d'utilisation de accepted
auront une date d'expiration définie dans le champ valid_until. Vous devez accepter les conditions d'utilisation de required
avant le valid_until
pour que le compte conserve un contrat valide. Lorsqu'ils acceptent de nouvelles conditions d'utilisation, les tiers doivent afficher le texte associé à l'accord sur les conditions d'utilisation donné (l'URL du fichier contenant le texte est ajoutée dans le message "Obligatoire" ci-dessous sous la forme tos_file_uri). L'acceptation des conditions d'utilisation se fait en appelant la fonction "accepte" sur la ressource TermsOfService.
Champs | |
---|---|
name |
Identifiant. Nom de ressource de la version des conditions d'utilisation. Format : |
region_code |
Code de région tel que défini par https://cldr.unicode.org/. Il s'agit du pays auquel l'État actuel s'applique. |
terms_of_service_kind |
Type de conditions d'utilisation associé à la version spécifique. |
accepted |
Conditions d'utilisation acceptées de ce type et pour le region_code associé |
required |
Conditions d'utilisation requises |
TermsOfServiceKind
Genre "TermsOfService".
Enums | |
---|---|
TERMS_OF_SERVICE_KIND_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
MERCHANT_CENTER |
d'une demande d'inscription à Merchant Center. |
TransitTable
Tableau du délai d'acheminement, nombre de jours ouvrés passés en transit en fonction des dimensions des lignes et des colonnes. Vous pouvez définir min_transit_days
, max_transit_days
ou transit_time_table
, mais pas les deux.
Champs | |
---|---|
postal_code_group_names[] |
Obligatoire. Une liste de noms de régions |
transit_time_labels[] |
Obligatoire. Liste des libellés du délai d'acheminement. La dernière valeur peut être |
rows[] |
Obligatoire. S'il n'y a qu'un seul ensemble de dimensions |
TransitTimeRow
S'il n'y a qu'un seul ensemble de dimensions postal_code_group_names
ou transit_time_labels
, plusieurs lignes comportent chacune une valeur pour cette dimension. S'il existe deux dimensions, chaque ligne correspond à un postal_code_group_names
et les colonnes (valeurs) à un transit_time_labels
.
Champs | |
---|---|
values[] |
Obligatoire. Délai d'acheminement (min.-max.) en jours ouvrés. |
TransitTimeValue
Délai d'acheminement (min.-max.) en jours ouvrés.
Champs | |
---|---|
min_transit_days |
Délai d'acheminement minimal en jours ouvrés. 0 correspond à une livraison le même jour, 1 à une livraison le lendemain. |
max_transit_days |
La valeur doit être supérieure ou égale à |
UnclaimHomepageRequest
Message de requête pour la méthode UnclaimHomepage
.
Champs | |
---|---|
name |
Obligatoire. Nom de la page d'accueil dont vous ne souhaitez plus revendiquer la propriété. Format : |
UpdateAccountRequest
Message de requête pour la méthode UpdateAccount
.
Champs | |
---|---|
account |
Obligatoire. Nouvelle version du compte. |
update_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
UpdateBusinessIdentityRequest
Message de requête pour la méthode UpdateBusinessIdentity
.
Champs | |
---|---|
business_identity |
Obligatoire. Nouvelle version de l'identité de l'entreprise. |
update_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
UpdateBusinessInfoRequest
Message de requête pour la méthode UpdateBusinessInfo
.
Champs | |
---|---|
business_info |
Obligatoire. Nouvelle version des informations sur l'établissement. |
update_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
UpdateEmailPreferencesRequest
Message de requête pour la méthode UpdateEmailPreferences.
Champs | |
---|---|
email_preferences |
Obligatoire. Préférences relatives aux e-mails à mettre à jour. |
update_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
UpdateHomepageRequest
Message de requête pour la méthode UpdateHomepage
.
Champs | |
---|---|
homepage |
Obligatoire. Nouvelle version de la page d'accueil. |
update_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
UpdateRegionRequest
Message de requête pour la méthode UpdateRegion
.
Champs | |
---|---|
region |
Obligatoire. Région mise à jour. |
update_mask |
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_mask |
Obligatoire. Liste des champs en cours de mise à jour. |
Utilisateur
Un utilisateur.
Champs | |
---|---|
name |
Identifiant. Nom de ressource de l'utilisateur. Format : Utilisez |
state |
Uniquement en sortie. État de l'utilisateur. |
access_rights[] |
Facultatif. Les droits d'accès dont dispose l'utilisateur. |
État
États possibles d'un utilisateur.
Enums | |
---|---|
STATE_UNSPECIFIED |
Valeur par défaut. Cette valeur n'est pas utilisée. |
PENDING |
L'utilisateur est en attente de confirmation. Dans cet état, l'utilisateur doit d'abord accepter l'invitation avant d'effectuer d'autres actions. |
VERIFIED |
L'utilisateur est validé. |
Valeur
Valeur unique d'un groupe de tarifs ou valeur de la cellule d'un tableau de groupes de tarifs. Vous ne devez définir qu'un seul des paramètres suivants : no_shipping
, flat_rate
, price_percentage
, carrier_rateName
ou subtable_name
.
Champs | |
---|---|
no_shipping |
Si la valeur est "true", le produit ne peut pas être expédié. Doit être défini sur "true" et ne peut être défini que si aucun autre champ n'est défini. |
flat_rate |
Un taux fixe. Ne peut être défini que si aucun autre champ n'est défini. |
price_percentage |
Pourcentage du prix représenté sous forme de nombre en notation décimale (par exemple, |
carrier_rate |
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 du tableau (par exemple, pas pour des valeurs uniques) et uniquement si aucun autre champ n'est défini. |
Entrepôt
Un entrepôt de traitement des commandes qui stocke et gère l'inventaire. Balise suivante: 7
Champs | |
---|---|
name |
Obligatoire. Nom de l'entrepôt. Doit être unique dans le compte. |
shipping_address |
Obligatoire. Adresse de livraison de l'entrepôt. |
cutoff_time |
Obligatoire. Heure limite à laquelle une commande peut être acceptée et dont le traitement peut commencer. Les commandes ultérieures seront traitées le jour suivant. L'heure est basée sur le code postal de l'entrepôt. |
handling_days |
Obligatoire. Nombre de jours nécessaires à cet entrepôt pour emballer et expédier un article. Cette valeur s'applique au niveau de l'entrepôt, mais peut être remplacée au niveau de l'offre en fonction des attributs d'un article. |
business_day_config |
Jours ouvrés de l'entrepôt. Si cette règle n'est pas configurée, la valeur est définie par défaut du lundi au vendredi. |
WarehouseBasedDeliveryTime
Indique que le délai de livraison doit être calculé pour chaque entrepôt (adresse d'origine de l'expédition) en fonction des paramètres du transporteur sélectionné. Si ce champ est défini, aucun autre champ lié au délai d'acheminement dans delivery_time
ne doit être défini.
Champs | |
---|---|
carrier |
Obligatoire. Opérateur, tel que |
carrier_service |
Obligatoire. Service de transporteur, tel que |
warehouse |
Obligatoire. Nom de l'entrepôt. Il doit correspondre à [warehouse][ShippingSetting.warehouses.name]. |
WarehouseCutoffTime
Heure limite à laquelle une commande peut être acceptée et dont le traitement peut commencer. Les commandes ultérieures seront traitées le jour suivant. L'heure est basée sur le code postal de l'entrepôt.
Champs | |
---|---|
hour |
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 jour même par l'entrepôt. Les minutes sont basées sur le fuseau horaire de l'entrepôt. |