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

Un budget de 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 la ressource associée au budget de la campagne. Le nom des ressources du budget de la campagne se présente comme suit: `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 à laquelle ce budget de campagne partagé s'aligne. 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 doivent également utiliser cette stratégie d'enchères.
`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 reçoit un ID de budget. Un ID de budget peut être partagé entre différentes campagnes. Le système répartira ensuite le budget 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é. Les budgets de campagne qui ne sont pas partagés explicitement tirent leur nom de la campagne associée. La longueur de cette chaîne doit être comprise entre 1 et 255 inclus, en octets UTF-8 (coupé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 pour la durée de vie, dans la devise locale du compte. 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" si aucune valeur n'est spécifiée lors d'une opération de création. Si la valeur est "true", le budget a été créé dans le but de le partager entre une ou plusieurs campagnes. Si la valeur est "false", le budget a été créé dans le but de n'être utilisé que pour une seule campagne. Le nom et l'état du budget sont synchronisés avec ceux de la campagne. Toute tentative de partage du budget avec une autre campagne entraînera une erreur. Un budget non partagé peut devenir un budget partagé explicitement. Vous devez également attribuer un nom au budget lors de la même opération. Un budget de campagne partagé ne peut en aucun cas être désactivé.
`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, il sera défini 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 la variation 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 microsecondes 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 hebdomadaires 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

Statuts 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 a été 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 limitera 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 le plus rapidement 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 une 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. Limite les dépenses quotidiennes qui correspondent 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 de 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 votre 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.