একটি sdfdownloadtasks.create অনুরোধ একটি দীর্ঘ-চলমান অপারেশন তৈরি করে। এই অপারেশনটি স্ট্রাকচার্ড ডেটা ফাইল (SDF) তৈরি করে।
অনুরোধ ক্ষেত্রগুলি আপনার SDF নির্ধারণ করে:
-
partnerIdবাadvertiserId: SDF-এর বিষয়বস্তুকে প্রদত্ত পার্টনার বা বিজ্ঞাপনদাতার প্রেক্ষাপটে সীমাবদ্ধ করে। এই ফিল্ডগুলোর মধ্যে কেবল একটিই সেট করা যাবে। -
version: কোন SDF সংস্করণ ব্যবহার করা হবে তা নির্ধারণ করে। সেট করা না থাকলে, এটি ডিফল্টরূপে পার্টনার বা বিজ্ঞাপনদাতার সেটিং ব্যবহার করবে। -
parentEntityFilter,idFilterবাinventorySourceFilter: 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']);