Pour discuter de nos produits et nous faire part de vos commentaires, rejoignez le canal Discord officiel Google Ads sur le serveur de la communauté Google Advertising and Measurement.
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Les brouillons de campagne vous permettent de préparer un ensemble de modifications à apporter à une campagne de base. Chaque brouillon de campagne est associé à une campagne de base et à une campagne brouillon.
La campagne de base est une campagne normale de votre compte, avec des annonces, des groupes d'annonces et d'autres ressources.
La campagne brouillon est un calque virtuel où les modifications sont agrégées à mesure que vous effectuez des opérations, mais n'affectent aucune campagne réelle de votre compte. Une fois que vous êtes satisfait de l'état de la campagne brouillon, vous pouvez l'appliquer à une campagne réelle de plusieurs façons.
Créer un brouillon
La création d'un CampaignDraft est aussi simple que celle de n'importe quelle autre entité dans l'API Google Ads. Créez un CampaignDraft et spécifiez ses base_campaign et name, puis appelez CampaignDraftService.MutateCampaignDrafts en transmettant le CampaignDraft nouvellement créé en tant qu'opération create.
La requête create se comporte comme un appel d'API classique, car une réponse est renvoyée immédiatement.
Modifier une campagne brouillon
Une fois votre brouillon de campagne créé, vous devrez rechercher le nom de ressource de la campagne brouillon associée pour pouvoir commencer à apporter des modifications. Pour ce faire, vous pouvez utiliser la requête suivante dans GoogleAdsService.SearchStream :
Une fois que vous avez le nom de ressource de votre campagne brouillon, vous pouvez la modifier de la même manière que n'importe quelle campagne réelle de votre compte. La campagne brouillon ne peut pas diffuser d'annonces, mais sert de zone de préparation pour les modifications que vous pourrez appliquer ultérieurement à une campagne réelle.
Promouvoir ou supprimer une campagne brouillon
Une fois que vous avez configuré votre campagne brouillon, plusieurs options s'offrent à vous.
Promouvoir la campagne brouillon dans la campagne de base, en appliquant toutes les modifications que vous avez apportées à la campagne brouillon dans la campagne de base. Il s'agit d'une opération asynchrone. Pour ce faire, appelez CampaignDraftService.PromoteCampaignDraft.
Supprimez la campagne brouillon en définissant son status sur REMOVED. Les modifications seront alors supprimées si vous décidez de ne pas continuer. Il s'agit d'une opération synchrone qui fonctionne comme n'importe quel autre appel d'API.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 2025/08/27 (UTC)."],[[["\u003cp\u003eCampaign drafts provide a virtual environment (draft campaign) to stage changes to an existing campaign (base campaign) without affecting live ads.\u003c/p\u003e\n"],["\u003cp\u003eCreating a campaign draft is a simple process involving specifying the base campaign and draft name, while draft campaign modifications follow standard campaign editing procedures.\u003c/p\u003e\n"],["\u003cp\u003eYou can promote the draft campaign, applying the changes to the base campaign asynchronously, or remove the draft campaign discarding changes entirely.\u003c/p\u003e\n"],["\u003cp\u003ePromoting a draft campaign is an asynchronous operation, providing a mechanism to track its progress without repeated API calls.\u003c/p\u003e\n"]]],[],null,["# Campaign Drafts\n\nCampaign drafts are a way of staging some set of intended changes to a base\ncampaign. Each campaign draft has a base campaign and a draft campaign\nassociated with it.\n\n- The base campaign is a normal campaign in your account, with ads, ad groups, and other resources.\n- The draft campaign is a virtual layer where changes are aggregated as you perform operations, but don't affect any real campaigns in your account. Once you are satisfied with the state of the draft campaign, you can apply it to a real campaign in a few different ways.\n\n| **Key Term:** The **campaign draft** is a resource you use to create new drafts from a base campaign and to determine associations between base campaigns and draft campaigns. The **draft campaign** is a virtual campaign that acts as a campaign but cannot serve ads.\n\nCreating a draft\n----------------\n\nCreating a [`CampaignDraft`](/google-ads/api/reference/rpc/v21/CampaignDraft) is as simple as any\nother entity creation in the Google Ads API. Create a `CampaignDraft` and specify its\n[`base_campaign`](/google-ads/api/reference/rpc/v21/CampaignDraft#base_campaign) and\n[`name`](/google-ads/api/reference/rpc/v21/CampaignDraft#name), then call\n[`CampaignDraftService.MutateCampaignDrafts`](/google-ads/api/reference/rpc/v21/CampaignDraftService),\npassing in the newly created `CampaignDraft` as a\n[`create`](/google-ads/api/reference/rpc/v21/CampaignDraftOperation/Create) operation.\n\nThe [`create`](/google-ads/api/reference/rpc/v21/CampaignDraftOperation/Create) request behaves\nlike a typical API call in that a response is returned immediately.\n\nModifying a draft campaign\n--------------------------\n\nOnce you create your campaign draft, you will need to look up the resource name\nof its associated draft campaign so that you can begin making changes. You can\ndo this using the following query in\n[`GoogleAdsService.SearchStream`](/google-ads/api/reference/rpc/v21/GoogleAdsService/SearchStream): \n\n SELECT campaign_draft.draft_campaign\n FROM campaign_draft\n WHERE campaign_draft.resource_name = \"CAMPAIGN_DRAFT_RESOURCE_NAME_HERE\"\n\nOnce you have your draft campaign resource name, you can modify that campaign\nthe same way you would any real campaign in your account. The draft campaign\ncannot serve ads but serves as a staging area for changes that you can apply to\na real campaign later.\n\nPromote or remove a draft campaign\n----------------------------------\n\n| **Key Term:** Asynchronous operations in the Google Ads API return what's called a **longrunning operation**. Longrunning operations serve as a convenient way to poll for operation completion without needing to make a full API call.\n\nAfter you are done configuring your draft campaign, you have a few options.\n\n1. **Promote** the draft campaign to the base campaign, applying all the changes you made in the draft campaign to the base campaign. This is an **asynchronous operation** . This can be performed by calling [`CampaignDraftService.PromoteCampaignDraft`](/google-ads/api/reference/rpc/v21/CampaignDraftService/PromoteCampaignDraft).\n2. **Remove the campaign draft** by setting its [`status`](/google-ads/api/reference/rpc/v21/CampaignDraft#status) to `REMOVED`. This will throw away the changes if you decided not to proceed. This is a synchronous operation and works like any other API call."]]
