다운로드 작업 만들기

구조화된 데이터 파일 (SDF)을 생성하는 다운로드 작업을 만들기 위한 sdfdownloadtasks.create 요청을 실행합니다.

요청의 다음 필드를 사용하여 SDF를 정의합니다.

• partnerId 또는 advertiserId: SDF를 채우는 리소스의 상위 리소스 (파트너 또는 광고주)를 정의하는 상호 배타적인 필드입니다.
• version: 파트너 또는 광고주 수준에서 설정된 기본값과 다른 경우 사용할 SDF 버전입니다.
• parentEntityFilter, idFilter 또는 inventorySourceFilter: 포함할 파일 형식 및 리소스를 지정하는 데 사용되는 필터를 할당하는 상호 배타적인 필드입니다.

이 코드 스니펫을 사용하여 지정된 광고주의 게재 신청서 및 광고 항목 구조화된 데이터 파일의 다운로드 작업을 생성하고 제공된 캠페인 ID의 범위 내에서 실행합니다.

경고: 한 사용자는 한 번에 실행되는 sdfdownloadtask 작업이 20개로 제한됩니다. 더 만들려고 하면 오류가 반환됩니다.

# 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-id, ...]

# 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.')