- Ressource: ShippingSettings
- Service
- DeliveryTime
- CutoffTime
- TransitTable
- TransitTimeRow
- TransitTimeValue
- BusinessDayConfig
- Jour de la semaine
- WarehouseBasedDeliveryTime
- RateGroup
- Value
- Table
- En-têtes
- Poids
- WeightUnit
- LocationIdSet
- Ligne
- CarrierRate
- ShipmentType
- MinimumOrderValueTable
- StoreCodeSetWithMov
- StoreConfig
- StoreServiceType
- CutoffConfig
- LocalCutoffTime
- Distance
- Unité
- LoyaltyProgram
- LoyaltyProgramTiers
- Entrepôt
- Adresse
- WarehouseCutoffTime
- Méthodes
Ressource: ShippingSettings
Paramètre de livraison du compte marchand.
Représentation JSON |
---|
{ "name": string, "services": [ { object ( |
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'asynchronie. 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 :
|
Service
Service de livraison.
Représentation JSON |
---|
{ "deliveryCountries": [ string ], "rateGroups": [ { object ( |
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 "minimumOrderValueTable". |
minimum |
Tableau des montants minimaux de commande par magasin pour le type de traitement "Retrait en magasin". Ne peut pas être défini avec "minimumOrderValue". |
store |
Liste des magasins depuis lesquels vos produits sont livrés. Cette option n'est valide que pour le type de livraison en magasin. |
DeliveryTime
Temps passé dans les divers aspects, de la commande à la livraison du produit.
Représentation JSON |
---|
{ "warehouseBasedDeliveryTimes": [ { object ( |
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. Les valeurs "minHandlingDays" et "maxHandlingDays" doivent être définies 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. |
CutoffTime
Définition de l'heure limite en jours ouvrés.
Représentation JSON |
---|
{ "hour": integer, "minute": integer, "timeZone": string } |
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". |
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 minTransitDays
, maxTransitDays
ou transitTimeTable
, mais pas les trois.
Représentation JSON |
---|
{
"postalCodeGroupNames": [
string
],
"transitTimeLabels": [
string
],
"rows": [
{
object ( |
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 postalCodeGroupNames
ou transitTimeLabels
est défini, plusieurs lignes comportent chacune une valeur pour cette dimension. S'il y a deux dimensions, chaque ligne correspond à un postalCodeGroupNames
et les colonnes (valeurs) à un transitTimeLabels
.
Représentation JSON |
---|
{
"values": [
{
object ( |
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.
Représentation JSON |
---|
{ "minTransitDays": integer, "maxTransitDays": integer } |
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 à |
BusinessDayConfig
Jours ouvrés de l'entrepôt.
Représentation JSON |
---|
{
"businessDays": [
enum ( |
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 |
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 deliveryTime
ne doit être défini.
Représentation JSON |
---|
{ "carrier": string, "carrierService": string, "warehouse": string } |
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] |
RateGroup
Définitions des groupes de frais de port. Seul le dernier est autorisé à avoir applicableShippingLabels
vide, ce qui signifie dans ce cas précis "Tout le reste". L'autre applicableShippingLabels
ne doit pas se superposer.
Représentation JSON |
---|
{ "applicableShippingLabels": [ string ], "subtables": [ { object ( |
Champs | |
---|---|
applicable |
Obligatoire. Liste des é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. |
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 noShipping
, flatRate
, pricePercentage
, carrier_rateName
et subtable_name
.
Représentation JSON |
---|
{
"noShipping": boolean,
"flatRate": {
object ( |
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. |
Tableau
Un tableau définissant le groupe de tarifs, lorsque singleValue
n'est pas assez parlant.
Représentation JSON |
---|
{ "rows": [ { object ( |
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. |
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
, postalCodeGroupNames
ou location
.
Représentation JSON |
---|
{ "prices": [ { object ( |
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 amountMicros = -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 amountMicros = -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. |
Poids
Poids représenté sous forme de valeur dans une chaîne et d'unité.
Représentation JSON |
---|
{
"unit": enum ( |
Champs | |
---|---|
unit |
Obligatoire. Unité de poids. Les valeurs acceptées sont: kg et lb |
amount |
Obligatoire. Poids représenté sous forme de nombre en micros (1 million de micros équivaut à l'unité standard de la devise, par exemple, 1 kg = 1 000 000 micros). Vous pouvez également définir ce champ sur l'infini en le définissant sur -1. Ce champ n'accepte que les valeurs -1 et positives. |
WeightUnit
Unité de poids.
Enums | |
---|---|
WEIGHT_UNIT_UNSPECIFIED |
unité non spécifiée |
POUND |
Unité de poids. |
KILOGRAM |
kg |
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.
Représentation JSON |
---|
{ "locationIds": [ string ] } |
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). |
Ligne
Incluez une liste de cellules.
Représentation JSON |
---|
{
"cells": [
{
object ( |
Champs | |
---|---|
cells[] |
Obligatoire. Liste des cellules qui constituent la ligne. Doit avoir la même longueur que |
CarrierRate
Liste des tarifs de transporteurs que mainTable
ou singleValue
peuvent évoquer. Les services de transporteur compatibles sont définis sur la page https://support.google.com/merchants/answer/12577710?hl=en&ref_topic=12570808&sjid=10662598224319463032-NC#zippy=%2Cdelivery-cost-rate-type%2Ccarrier-rate-au-de-uk-and-us-only.
Représentation JSON |
---|
{
"name": string,
"carrier": string,
"carrierService": string,
"originPostalCode": string,
"percentageAdjustment": string,
"flatAdjustment": {
object ( |
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, |
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. |
MinimumOrderValueTable
Tableau des montants minimaux de commande par magasin pour le type de traitement "Retrait en magasin".
Représentation JSON |
---|
{
"storeCodeSetWithMovs": [
{
object ( |
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.
Représentation JSON |
---|
{
"storeCodes": [
string
],
"value": {
object ( |
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. |
StoreConfig
Liste des magasins depuis lesquels vos produits sont livrés. Cette option n'est valide que pour le type de livraison en magasin.
Représentation JSON |
---|
{ "storeCodes": [ string ], "storeServiceType": enum ( |
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. |
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 storeCodes sont éligibles à la livraison locale. |
CutoffConfig
Les configurations liées à la livraison locale expirent pour la journée.
Représentation JSON |
---|
{
"localCutoffTime": {
object ( |
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.
Représentation JSON |
---|
{ "hour": string, "minute": string } |
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. |
Distance
Rayon de livraison maximal. Cette information n'est requise que pour le type de livraison en magasin.
Représentation JSON |
---|
{
"value": string,
"unit": enum ( |
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 |
LoyaltyProgram
Programme de fidélité proposé par un marchand.
Représentation JSON |
---|
{
"loyaltyProgramTiers": [
{
object ( |
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.
Représentation JSON |
---|
{ "tierLabel": string } |
Champs | |
---|---|
tier |
Le sous-attribut libellé de niveau [tierLabel] 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. |
Entrepôt
Un entrepôt de traitement, qui stocke et gère l'inventaire.
Représentation JSON |
---|
{ "name": string, "shippingAddress": { object ( |
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". |
Adresse
Adresse de livraison de l'entrepôt.
Représentation JSON |
---|
{ "streetAddress": string, "city": string, "administrativeArea": string, "postalCode": string, "regionCode": string } |
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"). |
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.
Représentation JSON |
---|
{ "hour": integer, "minute": integer } |
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. |
Méthodes |
|
---|---|
|
Récupérez des informations sur les paramètres de livraison. |
|
Remplacez le paramètre de livraison d'un marchand par le paramètre de livraison sur demande. |