리소스 활성화

베타: 디맨드젠 캠페인 리소스의 검색 및 관리는 베타 버전입니다. 이 기능은 2026년 6월 10일 부터 모든 파트너에게 출시되기 시작하며 2026년 6월 24일 부터 모든 파트너가 사용할 수 있게 됩니다.

디맨드젠 캠페인 리소스를 만들고 구성한 후 entityStatus 필드를 ENTITY_STATUS_ACTIVE로 업데이트하여 광고 게재를 시작할 수 있습니다. 광고 게재를 시작하려면 세 가지 리소스가 모두 활성 상태여야 합니다.

LineItem 리소스는 "초안" EntityStatus로 만들어야 하며 후속 요청에서 활성화해야 합니다. AdGroup 및 AdGroupAd 리소스는 '활성' EntityStatus로 만들 수 있지만 이러한 리소스를 '일시중지됨' 상태로 만드는 것이 좋습니다. 이렇게 하면 후속 요청에서 리소스를 활성화하기 전에 타겟팅을 할당하고 올바른 구성을 확인할 수 있습니다.

광고 항목 활성화

광고 항목을 활성화하는 방법은 다음과 같습니다.

자바

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

광고그룹 활성화

광고그룹을 활성화하는 방법은 다음과 같습니다.

자바

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

광고 활성화

광고를 활성화하는 방법은 다음과 같습니다.

자바

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