ایجاد وظیفه دانلود

یک درخواست sdfdownloadtasks.create یک عملیات طولانی مدت ایجاد می‌کند. این عملیات فایل‌های داده ساختاریافته (SDF) را تولید می‌کند.

فیلدهای درخواست، SDF های شما را تعریف می‌کنند:

• partnerId یا advertiserId : محتوای SDFها را به زمینه‌ی شریک یا تبلیغ‌کننده‌ی داده شده محدود می‌کند. فقط یکی از فیلدها را می‌توان تنظیم کرد.
• version : نسخه SDF مورد استفاده را تعریف می‌کند. در صورت عدم تنظیم، به طور پیش‌فرض روی تنظیمات شریک یا تبلیغ‌کننده تنظیم می‌شود.
• parentEntityFilter ، idFilter یا inventorySourceFilter : محتوای SDFها را تعریف می‌کند. فقط یکی از فیلدها را می‌توان تنظیم کرد.

در اینجا نحوه ایجاد یک وظیفه دانلود که SDF های ترتیب درج و آیتم های خطی را برای کمپین های داده شده تولید می کند، آورده شده است:

هشدار: یک کاربر فقط می‌تواند بیست وظیفه دانلود را همزمان اجرا کند. تلاش برای ایجاد وظایف بیشتر منجر به خطا خواهد شد.

جاوا

// Provide the ID of the parent advertiser of the resources to retrieve.
long advertiserId = advertiser-id;

// Provide the Structured Data Files version to download.
String sdfVersion = sdf-version;

// Provide the IDs of the parent campaigns of the resources to retrieve.
List<Long> campaignIds = campaign-ids;

// Create the filter structure.
ParentEntityFilter parentEntityFilter =
    new ParentEntityFilter()
        .setFileType(Arrays.asList("FILE_TYPE_INSERTION_ORDER", "FILE_TYPE_LINE_ITEM"))
        .setFilterType("FILTER_TYPE_CAMPAIGN_ID")
        .setFilterIds(campaignIds);

// Configure and create the SDF download task.
Operation operation =
    service
        .sdfdownloadtasks()
        .create(
            new CreateSdfDownloadTaskRequest()
                .setVersion(sdfVersion)
                .setAdvertiserId(advertiserId)
                .setParentEntityFilter(parentEntityFilter))
        .execute();

// Print the resulting operation name.
System.out.printf("Operation %s was created.", operation.getName());

پایتون

# Provide the ID of the parent advertiser of the resources to retrieve.
advertiser_id = advertiser-id

# Provide the Structured Data Files version to download.
sdf_version = sdf-version

# Provide the IDs of the parent campaigns of the resources to retrieve.
campaign_ids = campaign-ids

# Create the request body.
body = {
    "version": sdf_version,
    "advertiserId": advertiser_id,
    "parentEntityFilter": {
        "fileType": ["FILE_TYPE_INSERTION_ORDER", "FILE_TYPE_LINE_ITEM"],
        "filterType": "FILTER_TYPE_CAMPAIGN_ID",
        "filterIds": campaign_ids,
    },
}

# Create the operation.
operation = service.sdfdownloadtasks().create(body=body).execute()

# Print resulting operation name.
print(f'Operation {operation["name"]} was created.')

پی اچ پی

// Provide the ID of the parent advertiser of the resources to retrieve.
$advertiserId = advertiser-id;

// Provide the Structured Data Files version to download.
$sdfVersion = sdf-version;

// Provide the IDs of the parent campaigns of the resources to retrieve.
$campaignIds = campaign-ids;

// Create the filter structure.
$filter = new Google_Service_DisplayVideo_ParentEntityFilter();
$filter->setFileType(array('FILE_TYPE_INSERTION_ORDER','FILE_TYPE_LINE_ITEM'));
$filter->setFilterType('FILTER_TYPE_CAMPAIGN_ID');
$filter->setFilterIds($campaignIds);

// Configure and create the SDF download task.
$createDownloadRequest = new Google_Service_DisplayVideo_CreateSdfDownloadTaskRequest();
$createDownloadRequest->setVersion($sdfVersion);
$createDownloadRequest->setAdvertiserId($advertiserId);
$createDownloadRequest->setParentEntityFilter($filter);

// Call the API, creating the SDF Download Task.
$operation = $this->service->sdfdownloadtasks->create(
    $createDownloadRequest
);

// Print the resulting operation name.
printf('<p>Operation %s was created.</p>', $operation['name']);