В каждой новой позиции необходимо указать, будет ли в ней показываться политическая реклама Европейского союза (ЕС). Загрузка через Display & Video 360 API и SDF без таких указаний невозможна. Подробнее см. на странице «Устаревшие» .
Обязательно. Идентификатор рекламодателя, для которого нужно вывести список креативов.
Параметры запроса
Параметры
pageSize
integer
Запрошенный размер страницы. Должен быть от 1 до 200 Если не указан, по умолчанию будет 100 Возвращает код ошибки INVALID_ARGUMENT если указано недопустимое значение.
pageToken
string
Токен, идентифицирующий страницу результатов, которую должен вернуть сервер. Обычно это значение nextPageToken , возвращаемое предыдущим вызовом метода creatives.list . Если не указано иное, будет возвращена первая страница результатов.
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 полей может быть не более одного ограничения.
Поддерживаемые поля:
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 секунд и 200 мс: dynamic="true" AND minDuration="5.2s" AND (exchangeReviewStatus="EXCHANGE_GOOGLE_AD_MANAGER-REVIEW_STATUS_APPROVED" OR exchangeReviewStatus="EXCHANGE_APPNEXUS-REVIEW_STATUS_APPROVED")
Все видеокреативы, связанные с идентификатором позиции 1 или 2: creativeType="CREATIVE_TYPE_VIDEO" AND (lineItemIds:1 OR lineItemIds:2)
Найти креативы по нескольким идентификаторам креативов: creativeId=1 OR creativeId=2
Все креативы с временем обновления, большим или равным 2020-11-04T18:54:47Z (формат ISO 8601): updateTime>="2020-11-04T18:54:47Z"
Длина этого поля должна быть не более 500 символов.
Более подробную информацию можно получить, воспользовавшись нашим руководством по запросам LIST фильтров .
Текст запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит данные со следующей структурой:
Токен для получения следующей страницы результатов. Передайте это значение в поле pageToken при последующем вызове метода ListCreativesRequest для получения следующей страницы результатов. Если это поле равно NULL, это означает, что это последняя страница.
[[["Прост для понимания","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,[]]
