激活资源

创建并配置需求开发广告资源后，您可以将其 entityStatus 字段更新为 ENTITY_STATUS_ACTIVE，以便开始投放广告。所有这三项资源都必须处于有效状态，才能开始投放广告。

必须使用“草稿”EntityStatus 创建 LineItem 资源，并在后续请求中激活该资源。 AdGroup 和 AdGroupAd 资源可以使用“有效”EntityStatus 创建，但建议您使用“已暂停”状态创建这些资源。这样，您就可以在后续请求中激活资源之前分配定位条件并验证配置是否正确。

激活订单项

以下是启用订单项的方法：

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']
);

启用广告组

以下介绍了如何启用广告组：

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']
);

启用广告

以下是启用广告的方法：

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']
);
上一页
制作需求开发广告