2025년 9월 8일부터 모든 새 광고 항목은 유럽연합 (EU) 정치 광고를 게재할지 여부를 선언해야 합니다. 선언을 제공하지 않는 Display & Video 360 API 및 SDF 업로드는 실패합니다. 통합을 업데이트하여 이 선언을 하는 방법에 대한 자세한 내용은 지원 중단 페이지를 참고하세요.
요청한 페이지 크기입니다. 1~200의 값이어야 합니다. 지정하지 않으면 기본값은 100입니다. 잘못된 값이 지정되면 오류 코드 INVALID_ARGUMENT를 반환합니다.
pageToken
string
서버에서 반환할 결과 페이지를 식별하는 토큰입니다. 일반적으로 이는 creatives.list 메서드에 대한 이전 호출에서 반환된 nextPageToken 값입니다. 지정하지 않으면 결과의 첫 번째 페이지가 반환됩니다.
orderBy
string
목록을 정렬할 필드입니다. 사용 가능한 값:
creativeId(기본)
createTime
mediaDuration
dimensions (너비로 먼저 정렬한 다음 높이로 정렬)
기본 정렬 순서는 오름차순입니다. 필드에서 내림차순으로 지정하려면 서픽스 'desc'를 필드 이름에 추가해야 합니다. 예: createTime desc
filter
string
광고 소재 필드로 필터링할 수 있습니다.
지원되는 문법:
필터 표현식은 하나 이상의 제한사항으로 구성됩니다.
제한사항은 AND 또는 OR 논리 연산자로 결합할 수 있습니다. 제한 시퀀스는 AND를 암시적으로 사용합니다.
제한사항은 {field} {operator} {value} 형식입니다.
lineItemIds 필드는 HAS (:) 연산자를 사용해야 합니다.
updateTime 필드는 GREATER THAN OR EQUAL TO (>=) 또는 LESS THAN OR EQUAL TO (<=) 연산자를 사용해야 합니다.
다른 모든 필드는 EQUALS (=) 연산자를 사용해야 합니다.
entityStatus, minDuration, maxDuration, updateTime, dynamic 필드의 경우 제한이 최대 1개 있을 수 있습니다.
지원되는 필드:
approvalStatus
creativeId
creativeType
dimensions ({width}x{height} 형식으로 입력)
dynamic
entityStatus
exchangeReviewStatus ({exchange}-{reviewStatus} 형식으로 입력)
lineItemIds
maxDuration ({duration}s 형식으로 입력) 초만 지원됨)
minDuration ({duration}s 형식으로 입력) 초만 지원됨)
updateTime (ISO 8601 형식 또는 YYYY-MM-DDTHH:MM:SSZ으로 입력)
참고:
updateTime의 경우 광고 소재 리소스의 필드 값은 광고 소재가 마지막으로 업데이트된 시간을 반영하며, 여기에는 시스템에서 이루어진 업데이트 (예: 광고 소재 검토 업데이트)가 포함됩니다.
예:
모든 네이티브 광고 소재: creativeType="CREATIVE_TYPE_NATIVE"
크기가 300x400 또는 50x100인 모든 활성 광고 소재: entityStatus="ENTITY_STATUS_ACTIVE" AND (dimensions="300x400"
OR dimensions="50x100")
AdX 또는 AppNexus에서 승인된 모든 동적 광고 소재(최소 재생 시간 5초 200ms): dynamic="true" AND minDuration="5.2s" AND
(exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED"
OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
광고 항목 ID가 1 또는 2인 모든 동영상 광고 소재: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
여러 광고 소재 ID로 광고 소재 찾기: creativeId=1 OR creativeId=2
업데이트 시간이 2020-11-04T18:54:47Z 이상인 모든 광고 소재 (ISO 8601 형식): updateTime>="2020-11-04T18:54:47Z"
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-09-09(UTC)"],[[["\u003cp\u003eLists creatives, ordered by \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreateTime\u003c/code\u003e, \u003ccode\u003emediaDuration\u003c/code\u003e, or \u003ccode\u003edimensions\u003c/code\u003e, for a given advertiser.\u003c/p\u003e\n"],["\u003cp\u003eFilter creatives by \u003ccode\u003eapprovalStatus\u003c/code\u003e, \u003ccode\u003ecreativeId\u003c/code\u003e, \u003ccode\u003ecreativeType\u003c/code\u003e, \u003ccode\u003edimensions\u003c/code\u003e, \u003ccode\u003edynamic\u003c/code\u003e, \u003ccode\u003eentityStatus\u003c/code\u003e, \u003ccode\u003eexchangeReviewStatus\u003c/code\u003e, \u003ccode\u003elineItemIds\u003c/code\u003e, \u003ccode\u003emaxDuration\u003c/code\u003e, \u003ccode\u003eminDuration\u003c/code\u003e, or \u003ccode\u003eupdateTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eArchived creatives are excluded unless explicitly filtered for.\u003c/p\u003e\n"],["\u003cp\u003eResults are paginated, with control over page size and retrieval of subsequent pages using tokens.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video\u003c/code\u003e scope.\u003c/p\u003e\n"]]],[],null,[]]
