Activer les ressources

Après avoir créé et configuré vos ressources de génération de la demande, vous pouvez définir leurs champs entityStatus sur ENTITY_STATUS_ACTIVE pour commencer à diffuser des annonces. Les trois ressources doivent être actives pour que les annonces puissent être diffusées.

Les ressources LineItem doivent être créées avec l'état "brouillon" EntityStatus et activées dans une requête ultérieure. Les ressources AdGroup et AdGroupAd peuvent être créées avec l'état EntityStatus "active", mais il est recommandé de les créer avec l'état "paused" (mise en veille). Vous pouvez ainsi attribuer un ciblage et vérifier que la configuration est correcte avant d'activer les ressources dans les requêtes suivantes.

Activer un élément de campagne

Voici comment activer un élément de campagne :

Java

// The ID of the line item's parent advertiser.
long advertiserId = advertiser-id;

// The ID of the line item.
long lineItemId = line-item-id;

// Create the line item structure.
LineItem lineItem = new LineItem().setEntityStatus("ENTITY_STATUS_ACTIVE");

// Configure the patch request and set update mask to only update entity
// status.
LineItems.Patch request =
    service
        .advertisers()
        .lineItems()
        .patch(advertiserId, lineItemId, lineItem)
        .setUpdateMask("entityStatus");

// Update the line item.
LineItem response = request.execute();

// Display the new entity status of the updated line item.
System.out.printf(
    "LineItem %s now has entity status %s%n",
    response.getName(),
    response.getEntityStatus());

Python

# The ID of the line item's parent advertiser.
advertiser_id = advertiser-id

# The ID of the line item.
line_item_id = line-item-id

# Create the line item structure.
line_item_obj = {
    "entityStatus": "ENTITY_STATUS_ACTIVE",
}

# Build and execute request.
response = (
    service.advertisers()
    .lineItems()
    .patch(
        advertiserId=advertiser_id,
        lineItemId=line_item_id,
        updateMask="entityStatus",
        body=line_item_obj,
    )
    .execute()
)

# Display the entity status of the updated line item.
print(
    f"Line item {response['name']} now has entity status "
    f"{response['entityStatus']}."
)

PHP

// The ID of the line item's parent advertiser.
$advertiserId = advertiser-id;

// The ID of the line item.
$lineItemId = line-item-id;

// Create the line item structure.
$lineItem = new Google_Service_DisplayVideo_LineItem();
$lineItem->setEntityStatus('ENTITY_STATUS_ACTIVE');
$optParams = array('updateMask' => 'entityStatus');

// Call the API, updating the entity status for the identified line
// item.
try {
    $result = $this->service->advertisers_lineItems->patch(
        $advertiserId,
        $lineItemId,
        $lineItem,
        $optParams
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the entity status of the updated line item.
printf(
    '<p>Line Item %s now has entity status %s.</p>',
    $result['name'],
    $result['entityStatus']
);

Activer un groupe d'annonces

Pour activer un groupe d'annonces :

Java

// The ID of the ad group's parent advertiser.
long advertiserId = advertiser-id;

// The ID of the ad group.
long adGroupId = ad-group-id;

// Create the ad group structure.
AdGroup adGroup = new AdGroup().setEntityStatus("ENTITY_STATUS_ACTIVE");

// Configure the patch request and set update mask to only update entity
// status.
AdGroups.Patch request =
    service
        .advertisers()
        .adGroups()
        .patch(advertiserId, adGroupId, adGroup)
        .setUpdateMask("entityStatus");

// Update the ad group.
AdGroup response = request.execute();

// Display the entity status of the updated ad group.
System.out.printf(
    "Ad Group %s now has entity status %s%n",
    response.getName(),
    response.getEntityStatus());

Python

# The ID of the ad group's parent advertiser.
advertiser_id = advertiser-id

# The ID of the ad group.
ad_group_id = ad-group-id

# Create the ad group structure.
ad_group_obj = {
    "entityStatus": "ENTITY_STATUS_ACTIVE",
}

# Build and execute request.
response = (
    service.advertisers()
    .adGroups()
    .patch(
        advertiserId=advertiser_id,
        adGroupId=ad_group_id,
        updateMask="entityStatus",
        body=ad_group_obj,
    )
    .execute()
)

# Display the entity status of the updated ad group.
print(
    f"Ad group {response['name']} now has entity status "
    f"{response['entityStatus']}."
)

PHP

// The ID of the ad group's parent advertiser.
$advertiserId = advertiser-id;

// The ID of the ad group.
$adGroupId = ad-group-id;

// Create the ad group structure.
$adGroup = new Google_Service_DisplayVideo_AdGroup();
$adGroup->setEntityStatus('ENTITY_STATUS_ACTIVE');
$optParams = array('updateMask' => 'entityStatus');

// Call the API, updating the entity status for the identified ad group.
try {
    $result = $this->service->advertisers_adGroups->patch(
        $advertiserId,
        $adGroupId,
        $adGroup,
        $optParams
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the entity status of the updated ad group.
printf(
    '<p>Ad Group %s now has entity status %s.</p>',
    $result['name'],
    $result['entityStatus']
);

Activer une annonce

Voici comment activer une annonce :

Java

// The ID of the ad's parent advertiser.
long advertiserId = advertiser-id;

// The ID of the ad.
long adId = ad-group-ad-id;

// Create the ad group ad structure.
AdGroupAd ad =
    new AdGroupAd().setEntityStatus("ENTITY_STATUS_ACTIVE");

// Configure the patch request and set update mask to only update entity
// status.
AdGroupAds.Patch request =
    service
        .advertisers()
        .adGroupAds()
        .patch(advertiserId, adId, ad)
        .setUpdateMask("entityStatus");

// Update the ad group.
AdGroupAd response = request.execute();

// Display the new entity status of the updated ad.
System.out.printf(
    "Ad %s now has entity status %s%n",
    response.getName(),
    response.getEntityStatus());

Python

# The ID of the ad's parent advertiser.
advertiser_id = advertiser-id

# The ID of the ad.
ad_id = ad-group-ad-id

# Create the ad group ad structure.
ad_obj = {
    "entityStatus": "ENTITY_STATUS_ACTIVE",
}

# Build and execute request.
response = (
    service.advertisers()
    .adGroupAds()
    .patch(
        advertiserId=advertiser_id,
        adGroupAdId=ad_id,
        updateMask="entityStatus",
        body=ad_obj,
    )
    .execute()
)

# Display the new entity status of the updated ad.
print(
    f"Ad {response['name']} now has entity status "
    f"{response['entityStatus']}."
)

PHP

// The ID of the ad's parent advertiser.
$advertiserId = advertiser-id;

// The ID of the ad.
$adId = ad-group-ad-id;

// Create the ad group ad structure.
$ad = new Google_Service_DisplayVideo_AdGroupAd();
$ad->setEntityStatus('ENTITY_STATUS_ACTIVE');
$optParams = array('updateMask' => 'entityStatus');

// Call the API, updating the entity status for the identified ad.
try {
    $result = $this->service->advertisers_adGroupAds->patch(
        $advertiserId,
        $adId,
        $ad,
        $optParams
    );
} catch (\Exception $e) {
    $this->renderError($e);
    return;
}

// Display the new entity status of the updated ad.
printf(
    '<p>Ad %s now has entity status %s.</p>',
    $result['name'],
    $result['entityStatus']
);
Précédent
Créer une annonce de génération de la demande