Attention:Vous consultez la documentation de l'interface REST de l'API. La plupart de nos bibliothèques clientes officielles utilisent gRPC. Pour en savoir plus, consultez la présentation de REST.

Cette page a été traduite par l'API Cloud Translation.

CampaignBudget

Représentation JSON
BudgetStatus
BudgetDeliveryMethod
BudgetPeriod
BudgetType

Le budget d'une campagne

Représentation JSON

Représentation JSON
{ "resourceName": string, "status": enum (`BudgetStatus`), "deliveryMethod": enum (`BudgetDeliveryMethod`), "period": enum (`BudgetPeriod`), "type": enum (`BudgetType`), "alignedBiddingStrategyId": string, "id": string, "name": string, "amountMicros": string, "totalAmountMicros": string, "explicitlyShared": boolean, "referenceCount": string, "hasRecommendedBudget": boolean, "recommendedBudgetAmountMicros": string, "recommendedBudgetEstimatedChangeWeeklyClicks": string, "recommendedBudgetEstimatedChangeWeeklyCostMicros": string, "recommendedBudgetEstimatedChangeWeeklyInteractions": string, "recommendedBudgetEstimatedChangeWeeklyViews": string }

{
  "resourceName": string,
  "status": enum (BudgetStatus),
  "deliveryMethod": enum (BudgetDeliveryMethod),
  "period": enum (BudgetPeriod),
  "type": enum (BudgetType),
  "alignedBiddingStrategyId": string,
  "id": string,
  "name": string,
  "amountMicros": string,
  "totalAmountMicros": string,
  "explicitlyShared": boolean,
  "referenceCount": string,
  "hasRecommendedBudget": boolean,
  "recommendedBudgetAmountMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyClicks": string,
  "recommendedBudgetEstimatedChangeWeeklyCostMicros": string,
  "recommendedBudgetEstimatedChangeWeeklyInteractions": string,
  "recommendedBudgetEstimatedChangeWeeklyViews": string
}

Champs
`resourceName`	`string` Immuable. Nom de ressource du budget de la campagne. Le nom des ressources de budget de campagne se présente sous la forme suivante: `customers/{customerId}/campaignBudgets/{campaign_budget_id}`
`status`	`enum (BudgetStatus)` Uniquement en sortie. État du budget de cette campagne. Ce champ est en lecture seule.
`deliveryMethod`	`enum (BudgetDeliveryMethod)` Mode de diffusion qui détermine la fréquence à laquelle le budget de la campagne est dépensé. La valeur par défaut est STANDARD si elle n'est pas spécifiée lors d'une opération de création.
`period`	`enum (BudgetPeriod)` Immuable. Période au cours de laquelle dépenser le budget. En l'absence de spécification, la valeur par défaut est DAILY.
`type`	`enum (BudgetType)` Immuable. Type de budget de la campagne.
`alignedBiddingStrategyId`	`string (int64 format)` ID de la stratégie de portefeuille d'enchères avec laquelle le budget de cette campagne partagé est aligné. Lorsqu'une stratégie d'enchères et un budget de campagne sont alignés, ils sont associés au même ensemble de campagnes. Une fois qu'un budget de campagne est aligné sur une stratégie d'enchères, les campagnes ajoutées au budget d'une campagne doivent également utiliser cette stratégie.
`id`	`string (int64 format)` Uniquement en sortie. ID du budget de la campagne. Un budget de campagne est créé à l'aide de l'opération de création CampaignBudgetService et un ID de budget lui est attribué. Un ID de budget peut être partagé entre différentes campagnes. Le système répartira ensuite le budget de la campagne entre les différentes campagnes afin d'obtenir les meilleurs résultats possible.
`name`	`string` Nom du budget de la campagne. Lorsque vous créez un budget de campagne via CampaignBudgetService, vous devez attribuer un nom à chaque budget de campagne explicitement partagé. Le nom des budgets de campagne qui ne sont pas explicitement partagés est celui de la campagne associée. La longueur de cette chaîne doit être comprise entre 1 et 255 inclus, en octets UTF-8 (bordés).
`amountMicros`	`string (int64 format)` Montant du budget, dans la devise locale du compte. Le montant est exprimé en micro-unités, où un million équivaut à une unité de devise. Les dépenses mensuelles sont limitées à 30,4 fois ce montant.
`totalAmountMicros`	`string (int64 format)` Montant du budget depuis la création du compte, dans la devise locale Le montant est exprimé en micro-unités, où un million équivaut à une unité de devise.
`explicitlyShared`	`boolean` Indique si le budget est partagé explicitement. La valeur par défaut est "true" s'il n'est pas spécifié lors d'une opération de création. Si la valeur est "true", le budget a été créé en vue d'être partagé entre une ou plusieurs campagnes. Si la valeur est "false", le budget a été créé dans le but d'être utilisé pour une seule campagne. Le nom et l'état du budget restent synchronisés avec le nom et l'état de la campagne. Si vous essayez de partager le budget avec une autre campagne, vous obtiendrez une erreur. Un budget non partagé peut devenir un budget partagé explicitement. Vous devez également attribuer un nom au budget au cours de cette même opération. Un budget de campagne partagé ne peut jamais devenir non partagé.
`referenceCount`	`string (int64 format)` Uniquement en sortie. Nombre de campagnes qui utilisent activement le budget. Ce champ est en lecture seule.
`hasRecommendedBudget`	`boolean` Uniquement en sortie. Indique s'il existe un budget recommandé pour cette campagne. Ce champ est en lecture seule.
`recommendedBudgetAmountMicros`	`string (int64 format)` Uniquement en sortie. Montant du budget recommandé. Si aucune recommandation n'est disponible, la valeur sera définie sur le montant du budget. Le montant est exprimé en micro-unités, où un million équivaut à une unité de devise. Ce champ est en lecture seule.
`recommendedBudgetEstimatedChangeWeeklyClicks`	`string (int64 format)` Uniquement en sortie. Estimation de l'évolution du nombre de clics hebdomadaires si le budget recommandé est appliqué. Ce champ est en lecture seule.
`recommendedBudgetEstimatedChangeWeeklyCostMicros`	`string (int64 format)` Uniquement en sortie. Estimation de la variation du coût hebdomadaire en micros si le budget recommandé est appliqué. Un million équivaut à une unité monétaire. Ce champ est en lecture seule.
`recommendedBudgetEstimatedChangeWeeklyInteractions`	`string (int64 format)` Uniquement en sortie. Estimation de la variation du nombre d'interactions hebdomadaire si le budget recommandé est appliqué. Ce champ est en lecture seule.
`recommendedBudgetEstimatedChangeWeeklyViews`	`string (int64 format)` Uniquement en sortie. Estimation de l'évolution du nombre de vues hebdomadaires si le budget recommandé est appliqué. Ce champ est en lecture seule.

BudgetStatus

États possibles d'un budget.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`ENABLED`	Le budget est activé.
`REMOVED`	Le budget est supprimé.

BudgetDeliveryMethod

Modes de diffusion possibles d'un budget.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`STANDARD`	Le serveur du budget régulera la diffusion de manière uniforme sur toute la période.
`ACCELERATED`	Le serveur du budget ne limitera pas la diffusion, et les annonces seront diffusées aussi vite que possible.

BudgetPeriod

Période possible d'un budget.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`DAILY`	Budget quotidien.
`CUSTOM_PERIOD`	Budget personnalisé réintégré dans la version 5. Vous pouvez utiliser un budget personnalisé avec "total_amount" pour spécifier la limite de budget pour la durée de vie. Pour en savoir plus, consultez la page https://support.google.com/google-ads/answer/6385083.

BudgetType

Types de budgets possibles.

Enums
`UNSPECIFIED`	Non spécifié.
`UNKNOWN`	Utilisé pour la valeur renvoyée uniquement. Représente une valeur inconnue dans cette version.
`STANDARD`	Type de budget pour l'utilisation standard de Google Ads. Plafonne les dépenses quotidiennes au double du montant du budget spécifié. En savoir plus: https://support.google.com/google-ads/answer/6385083
`FIXED_CPA`	Type de budget avec un coût par acquisition (conversion) fixe. En savoir plus: https://support.google.com/google-ads/answer/7528254 Ce type n'est compatible qu'avec les campagnes avec AdvertisingChannelType.DISPLAY (à l'exception d'AdvertisingChannelSubType.DISPLAY_Gmail), BiddingStrategyType.TARGET_CPA et PaymentMode.CONVERSIONS.
`SMART_CAMPAIGN`	Type de budget pour la campagne intelligente. En savoir plus: https://support.google.com/google-ads/answer/7653509 Ce type n'est compatible qu'avec les campagnes avec AdvertisingChannelType.SMART et AdvertisingChannelSubType.SMART_CAMPAIGN.
`LOCAL_SERVICES`	Type de budget pour la campagne Local Services. En savoir plus: https://support.google.com/localservices/answer/7434558 Ce type n'est compatible qu'avec les campagnes avec AdvertisingChannelType.LOCAL_SERVICES.