Пролистывание результатов

Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

GoogleAdsService.Search поддерживает разбивку по страницам с фиксированным размером в 10 000 строк. Набор результатов запроса разбивается на несколько ответов, каждый из которых содержит 10 000 объектов.

Например, для следующего запроса:

SELECT
  ad_group.id,
  ad_group_criterion.type,
  ad_group_criterion.criterion_id,
  ad_group_criterion.keyword.text,
  ad_group_criterion.keyword.match_type
FROM ad_group_criterion
WHERE ad_group_criterion.type = KEYWORD

Если ваша учетная запись содержит 50 000 ключевых слов, набор результатов будет содержать 10 000 объектов GoogleAdsRow в первом ответе, а также next_page_token .

Чтобы получить следующие 10 000 строк, отправьте запрос еще раз, но обновите page_token запроса на next_page_token ответа. Обратите внимание, что next_page_token не заполняется в ответе, содержащем последний пакет строк.

Наши клиентские библиотеки автоматически обрабатывают подкачку. Вам нужно только перебирать строки ответа. Когда все строки на текущей странице возвращены, клиентская библиотека автоматически извлекает новую страницу строк от вашего имени, пока не будет получен весь набор данных. Если вы используете REST вместо gRPC, вы должны явно запрашивать каждую новую страницу.

Google Ads API внутренне кэширует весь набор данных, поэтому последующие запросы выполняются быстрее, чем первоначальный.

Ваш запрос должен оставаться неизменным в последующих запросах, чтобы можно было использовать преимущества кэшированных данных; запросы не будут способствовать увеличению вашей квоты, особенно для базового доступа . Если запрос отличается и отправляется вместе с тем же токеном страницы, возвращается ошибка.