Просмотр инвентаря

Обзор

Просмотр ассортимента в Центре действий позволяет отслеживать состояние загрузки, статус сопоставления мест и допуск к показу местного ассортимента объектов инфраструктуры.

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

С его помощью вы сможете:

  • Поиск и проверка всех поставщиков услуг и их статусов.
  • Диагностика ошибок проверки данных и нарушений правил в отношении контента.
  • Подавать апелляции на нарушения правил и отслеживать их статус.
  • Проверьте диагностику сопоставления поставщиков услуг и отправьте предложения по сопоставлению вручную.
  • Просматривайте необработанные полезные нагрузки JSON из последних добавлений фидов.

Столбцы таблицы инвентаря

В режиме списка показаны все загруженные поставщики услуг из фида объектов инфраструктуры, упорядоченные по иерархии объектов. Вы можете отфильтровать данные по идентификатору местного объекта инфраструктуры, статусу сопоставления, интеграции и платформе.

Столбцы сводной таблицы Описание
Идентификатор местного объекта инфраструктуры Уникальный идентификатор местного объекта, указанный в фиде (poi_id).
Название объекта инфраструктуры на местном языке Локализованное название местного объекта, извлеченное из фида.
Статус сопоставления Указывает, сопоставлен ли объект инфраструктуры с данными Google Карт:
• Да (зеленый значок) – объект успешно сопоставлен с местом на Google Картах.
• Нет (красный значок) – сопоставление не выполнено. Требуется проверка или предложение сопоставления.
Интеграция Это интеграция блока местного агрегатора.
Surface Целевая платформа показа (например, Поиск).
Статус показа Статус допуска к показу в реальном времени:
• Включено (зеленый индикатор): допущено к показу и активно показывается на платформах Google.
• Отключено (красный индикатор). Показ заблокирован из-за ошибок проверки, нарушений правил или несоответствия статуса.
Ошибки Количество активных проблем с уровнем серьезности "Ошибка". Если в данных о товаре есть ошибки, он не будет показываться ни на одной платформе.
Предупреждения Количество активных проблем с уровнем серьезности "Предупреждение". Объекты с предупреждениями по-прежнему могут показываться.
Информация о матче Содержит кнопку "Изменить совпадение", которая открывает интерактивную панель исправления совпадений.

Просмотр сведений об объекте инфраструктуры

Нажав на любой идентификатор объекта инфраструктуры в списке, вы перейдете на страницу с подробными сведениями об этом объекте.

В представлении сведений есть четыре раздела, которые можно развернуть:

1. Основная информация

Обобщает метаданные объекта высокого уровня:

  • Название POI: Название заведения, полученное в результате синтаксического анализа из data[].name.localizations.
  • POI ID – уникальный идентификатор объекта партнера (poi_id).
  • Источник данных. Точное название файла фида, из которого был получен объект.

2. Статус обслуживания

Показывает, соответствует ли реклама требованиям к показу, с разбивкой по интеграции и целевой платформе:

  • Интеграция и платформа. Вертикаль и целевая платформа (например, Local Aggregator Unit в Search).
  • Статус показа. Текущий статус Enabled или Disabled.
  • Проблемы. Значки всех активных ошибок и предупреждений (например, Unmatched entity, Policy Violation). Нажав на значок, вы откроете панель сведений о проблеме.
  • Апелляции. Статус апелляции или отмены решения (Under review, Approved или Rejected).

3. Информация о совпадении

Показывает диагностику сопоставления мест:

  • Входные данные для сопоставления. Отформатированный физический адрес, полученный из фида (street_address, locality, region, postal_code, country).
  • Тип соответствия. Механизм сопоставления, например Location.
  • Пространство имен соответствия. Тематика, к которой будут применяться изменения соответствия (например, Local Aggregator Unit).
  • Статус соответствия: Yes (зеленый) или No (красный).
  • Результат сопоставления. Название, адрес и идентификатор места в Google Картах.
  • Изменить сопоставление. Кнопка, открывающая диалоговое окно с предложением сопоставления.

4. Необработанный JSON

Интерактивное средство просмотра кода с номерами строк и подсветкой синтаксиса, в котором показывается вся полезная нагрузка JSON (item_proto). Это позволяет быстро отлаживать и проверять схемы. Значения данных, представленные здесь, будут отражать значения, полученные из фида объектов инфраструктуры.

Проблемы и рабочий процесс сортировки

Объекты, помеченные как проблемные, либо отключены (если помечены как ОШИБКА), либо работают с ограничениями (если помечены как ПРЕДУПРЕЖДЕНИЕ). Предупреждения о проблемах с объектами нельзя обжаловать. Чтобы устранить предупреждение, нужно решить проблему.

Типы нарушений: с возможностью апелляции и без

  1. Проблемы, которые нельзя обжаловать (технические проблемы, проблемы с качеством данных и предупреждения):
    • Ошибки в схеме, отсутствие обязательных полей, недействительные координаты, неработающие URL, повторяющиеся идентификаторы или неблокирующие предупреждения о контенте (например, названия компаний на языках, отличных от языка по умолчанию, или любые языки для описаний, отображаемых адресов и категорий заведений).
    • Решение. Партнеры должны исправить данные в исходном фиде и загрузить обновленный файл фида.
  2. Проблемы, которые можно обжаловать (блокировка контента и нарушение правил):
    • Срабатывает, когда обязательные текстовые или графические объекты объектов не проходят автоматическую проверку на безопасность контента с уровнем серьезности "Ошибка".
    • Решение. Если контент соответствует правилам платформы, партнеры могут нажать кнопку Подать апелляцию рядом с проблемой в Центре действий. Партнеры должны указать причину и обоснование, а наша команда по апелляциям рассмотрит и одобрит или отклонит запрос. Вы получите уведомление о принятом решении в инструменте и по электронной почте.

Каталог проблем с блоком местного агрегатора

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

Описание проблемы Уровень серьезности Код проблемы Затронутое поле / аргументы Можно ли подать апелляцию? Действие / правило
Отсутствует идентификатор объекта инфраструктуры ERROR MISSING_REQUIRED_FIELD poi_id Нет Укажите уникальное значение атрибута poi_id. Подробнее о спецификации фида объектов инфраструктуры…
Отсутствует региональная настройка по умолчанию для поля name ERROR MISSING_REQUIRED_FIELD name.default_locale Нет Укажите действительный код языка BCP 47 для региональных настроек по умолчанию. Подробнее о поддержке нескольких языков…
Не найдена локализация по умолчанию для поля name ERROR MISSING_REQUIRED_FIELD name.localizations Нет Укажите локализованное название объекта инфраструктуры на языке default_locale.
Отсутствует региональная настройка по умолчанию для поля description ERROR MISSING_REQUIRED_FIELD description.default_locale Нет Укажите действительную региональную настройку по умолчанию BCP 47 для описания свойства.
Не найдена локализация по умолчанию для поля description ERROR MISSING_REQUIRED_FIELD description.localizations Нет Добавьте описание на языке, указанном в атрибуте default_locale.
Отсутствует региональная настройка по умолчанию для поля display_address ERROR MISSING_REQUIRED_FIELD display_address.default_locale Нет Укажите действительную региональную настройку по умолчанию BCP 47 для отображаемого адреса.
Не найдена локализация по умолчанию для поля display_address ERROR MISSING_REQUIRED_FIELD display_address.localizations Нет Укажите отформатированный текст адреса на языке default_locale.
Превышено максимальное количество изображений ПРЕДУПРЕЖДЕНИЕ EXCEEDED_MAX_COUNT images Нет Добавляйте не более пяти изображений для каждого объекта инфраструктуры. Лишние изображения будут удалены.
Недопустимая широта ERROR INVALID_LATLNG location.latitude Нет Введите значение широты от -90.0 до +90.0. Подробнее об определении географических координат…
Недопустимая долгота ERROR INVALID_LATLNG location.longitude Нет Введите значение долготы от -180.0 до +180.0. Подробнее об определении географических координат…
Отсутствует координата широты ERROR MISSING_REQUIRED_FIELD location.latitude Нет Укажите широту, чтобы завершить пару координат. Подробнее об определении географических координат…
Не указана долгота ERROR MISSING_REQUIRED_FIELD location.longitude Нет Укажите значение долготы, чтобы завершить пару координат. Подробнее об определении географических координат…
Адрес отсутствует или не структурирован ERROR MISSING_REQUIRED_FIELD location.address Нет Укажите структурированный почтовый адрес, включая улицу, населенный пункт, почтовый индекс и страну.
Неправильный или недопустимый URL ERROR INVALID_ATTRIBUTE_VALUE url Нет Убедитесь, что в URL целевой страницы используется поддерживаемый протокол HTTP/HTTPS и допустимый синтаксис.
Недействительное или недоступное изображение ПРЕДУПРЕЖДЕНИЕ INVALID_IMAGE image.url Нет Убедитесь, что URL изображений общедоступны, не требуют аутентификации и не возвращают ошибки 4xx/5xx.
Повторяющийся идентификатор объекта инфраструктуры ERROR DUPLICATE_ENTITY poi_id Нет Убедитесь, что каждый poi_id уникален в пределах полезной нагрузки фида. Удалите повторяющиеся записи.
Повторяющийся сопоставленный объект ERROR DUPLICATE_MATCHED_ENTITY POI Нет Удалите повторяющиеся записи из фида или воспользуйтесь инструментом сопоставления объектов инфраструктуры, чтобы сопоставить отдельные компании с их независимыми данными в Google Картах.
Несопоставленный объект ERROR UNMATCHED_ENTITY POI Нет Сопоставьте объект инфраструктуры с местом на Google Картах с помощью инструмента Сопоставление объектов инфраструктуры.
Нарушение правил в отношении изображений ERROR SAFE_SEARCH_POLICY_VIOLATION_IMAGE image Да Удалите или замените помеченное изображение или нажмите Подать апелляцию, чтобы отправить обоснование. Ознакомьтесь с правилами Google Поиска в отношении изображений.
Нарушение правил в отношении текста – название по умолчанию ERROR SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Да Удалите или замените помеченный текст или нажмите Подать апелляцию. Ознакомьтесь с правилами в отношении текстового контента в Google Поиске.
Нарушение правил в отношении текста – название не по умолчанию ПРЕДУПРЕЖДЕНИЕ SAFE_SEARCH_POLICY_VIOLATION_TEXT name.localizations.*.text Нет Удалите или замените помеченный текст. Ознакомьтесь с правилами в отношении текстового контента в Google Поиске.
Нарушение правил в отношении текста – описание ПРЕДУПРЕЖДЕНИЕ SAFE_SEARCH_POLICY_VIOLATION_TEXT description.localizations.*.text Нет Удалите или замените помеченный текст описания. Ознакомьтесь с правилами в отношении текстового контента в Google Поиске.
Нарушение правил в отношении текста – отображаемый адрес ПРЕДУПРЕЖДЕНИЕ SAFE_SEARCH_POLICY_VIOLATION_TEXT display_address.localizations.*.text Нет Удалите или замените помеченный текст отображаемого адреса. Ознакомьтесь с правилами в отношении текстового контента в Google Поиске.
Отсутствует региональная настройка по умолчанию для категории заведения ERROR MISSING_REQUIRED_FIELD local_data.establishment_category.default_locale Нет Укажите значение для локализованной категории объекта инфраструктуры, соответствующей заявленному языку default_locale.
Не указан день, когда компания работает ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_day Нет Укажите действительный день открытия.
Не указаны часы работы ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.open_time Нет Укажите правильные часы работы.
Не указаны часы работы и выходные дни ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_day Нет Укажите действительный день закрытия в часы работы.
Не указаны часы работы ERROR MISSING_REQUIRED_FIELD local_data.business_hours.time_ranges.close_time Нет Укажите действительное время закрытия.
Часы работы: время открытия позже времени закрытия ERROR NOT_LESS_THAN_FIELD local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time Нет Укажите действительную пару значений времени открытия и закрытия, убедившись, что время открытия меньше времени закрытия.
Минимальное значение диапазона цен больше максимального ERROR INVALID_PRICE_RANGE local_data.price_range.min_price, local_data.price_range.max_price Нет Укажите действительный диапазон цен, в котором минимальная цена ниже максимальной.
Отсутствует идентификатор бренда ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.brand_id Нет Укажите действительный идентификатор бренда.
Повторяющийся идентификатор бренда в объекте инфраструктуры ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.brand_id Нет Убедитесь, что каждый brand_id уникален в полезной нагрузке объекта инфраструктуры. Удалите повторяющиеся записи.
Отсутствует URL бренда по умолчанию ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.default_url Нет Укажите действительный URL бренда по умолчанию.
Неверный формат или недопустимый URL бренда ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.default_url Нет Убедитесь, что URL бренда по умолчанию использует поддерживаемый протокол HTTP/HTTPS и правильный синтаксис.
Не указан URL локализованной целевой страницы бренда ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.url Нет Укажите действительный URL локализованной целевой страницы.
Неправильный или недействительный URL локальной целевой страницы бренда ERROR INVALID_ATTRIBUTE_VALUE local_data.brand_landing_pages.localized_landing_pages.url Нет Убедитесь, что URL локализованной целевой страницы использует поддерживаемый протокол HTTP/HTTPS и правильный синтаксис.
Повторяющийся URL локализованной целевой страницы бренда ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.url Нет Убедитесь, что каждый атрибут url уникален для локализованных целевых страниц объектов инфраструктуры. Удалите повторяющиеся записи.
Отсутствует локализованная целевая страница бренда ERROR MISSING_REQUIRED_FIELD local_data.brand_landing_pages.localized_landing_pages.locales Нет Укажите действительный набор региональных настроек для локализованной целевой страницы.
Повторяющийся регион для локализованной целевой страницы бренда ERROR DUPLICATE_UNIQUE_PROPERTY local_data.brand_landing_pages.localized_landing_pages.locales Нет Убедитесь, что каждый атрибут locale уникален для локализованных целевых страниц объектов инфраструктуры. Удалите повторяющиеся записи.
Нарушение правил в отношении текста – категория заведения ПРЕДУПРЕЖДЕНИЕ SAFE_SEARCH_POLICY_VIOLATION_TEXT local_data.establishment_category.localizations.*.text Нет Удалите или замените текст, относящийся к категории заведения. Ознакомьтесь с правилами в отношении текстового контента в Google Поиске.

Коды проблем

В разделах ниже приведены подробные сведения о причинах и способах устранения каждой проблемы.

Отсутствуют данные в обязательном для заполнения поле

Код проблемы: MISSING_REQUIRED_FIELD
Серьезность: ошибка (показ заблокирован).
Можно подать апелляцию: нет (устраните проблему, обновив фид объектов инфраструктуры).

Эта ошибка возникает, когда у загруженного объекта отсутствует один или несколько обязательных атрибутов, указанных в спецификации фида объектов инфраструктуры.

Проверьте панель сведений о проблеме, чтобы определить, какое именно свойство отсутствует, а затем примените соответствующее исправление:

1. Отсутствует идентификатор объекта инфраструктуры (poi_id)

  • Причина. Поле poi_id пустое, имеет значение null или отсутствует в корневом объекте.
  • Решение. Укажите постоянный уникальный строковый идентификатор объекта.
{
  "poi_id": "test_restaurant_1"
}

2. Отсутствует региональная настройка по умолчанию или локализованное название (name)

  • Причина. В объекте name отсутствует строка default_locale или массив localizations с соответствующим языком.
  • Решение. Укажите и default_locale, и хотя бы одну запись локализации, соответствующую этой локали.
{
  "name": {
    "localizations": [
      {
        "locale": "en",
        "text": "Tasty Bites Test Restaurant"
      }
    ],
    "default_locale": "en"
  }
}

3. Отсутствует региональная настройка по умолчанию или локализованный адрес (display_address)

  • Причина. В объекте display_address отсутствует строка default_locale или массив localizations.
  • Решение. Укажите и default_locale, и хотя бы одну запись локализации, соответствующую этому языку, для отформатированного почтового адреса.
{
  "display_address": {
    "localizations": [
      {
        "locale": "en",
        "text": "1600 Amphitheatre Pkwy, Mountain View, CA 94043"
      }
    ],
    "default_locale": "en"
  }
}

4. Отсутствуют региональные настройки по умолчанию или локализованное описание (description)

  • Причина. Если объект description включен, то отсутствует либо default_locale, либо соответствующая локализация.
  • Решение. Укажите default_locale и хотя бы одну запись локализации, соответствующую этому языку, для описания.
{
  "description": {
    "localizations": [
      {
        "locale": "en",
        "text": "A mock restaurant for testing the POI feed ingestion."
      }
    ],
    "default_locale": "en"
  }
}

5. Отсутствуют географические координаты (location.latitude / location.longitude)

  • Причина. В объекте location отсутствует числовое значение latitude или longitude.
  • Решение. Укажите значения latitude и longitude в виде чисел с плавающей запятой в стандартных десятичных градусах WGS84.
{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

6. Отсутствует структурированный почтовый адрес (location.address)

  • Причина. В объекте location.address отсутствуют обязательные компоненты адреса (country, locality или postal_code).
  • Решение. Заполните объект структурированного почтового адреса в соответствии со стандартами ISO.
{
  "location": {
    "address": {
      "country": "US",
      "locality": "Mountain View",
      "postal_code": "94043",
      "street_address": "1600 Amphitheatre Pkwy"
    }
  }
}

7. Отсутствуют региональные настройки по умолчанию для категории заведения (local_data.establishment_category.default_locale)

  • Причина. Объект local_data.establishment_category присутствует, но свойство default_locale отсутствует, пустое или не соответствует ни одной записи в массиве localizations.
  • Решение. Укажите действительный языковой тег BCP 47 для default_locale и добавьте хотя бы одну локализованную строку, соответствующую этому региону.
{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        }
      ]
    }
  }
}

8. Не указан день недели в часах работы (local_data.business_hours.time_ranges.open_day)

  • Причина. В файле local_data.business_hours.time_ranges отсутствует запись open_day или для нее задано значение DAY_OF_WEEK_UNSPECIFIED.
  • Решение. Укажите допустимую строку дня недели (например, "MONDAY", "TUESDAY" и т. д.).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

9. Не указаны часы работы (local_data.business_hours.time_ranges.open_time)

  • Причина. В записи local_data.business_hours.time_ranges отсутствует объект open_time.
  • Решение. Укажите open_time с hours (0–23) и minutes (0–59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

10. Не указан день закрытия в часах работы (local_data.business_hours.time_ranges.close_day)

  • Причина. В файле local_data.business_hours.time_ranges отсутствует запись close_day или для нее задано значение DAY_OF_WEEK_UNSPECIFIED.
  • Решение. Укажите допустимую строку дня недели (например, "MONDAY", "TUESDAY" и т. д.).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

11. Не указано время закрытия (local_data.business_hours.time_ranges.close_time)

  • Причина. В записи local_data.business_hours.time_ranges отсутствует объект close_time.
  • Решение. Укажите close_time с hours (0–23) и minutes (0–59).
{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 11, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 21, "minutes": 0 }
        }
      ]
    }
  }
}

12. Отсутствует идентификатор бренда (local_data.brand_landing_pages.brand_id)

  • Причина. В записи local_data.brand_landing_pages отсутствует или не заполнено поле brand_id.
  • Решение. Укажите непустой строковый идентификатор, соответствующий конфигурации зарегистрированного бренда партнера.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

13. Отсутствует URL бренда по умолчанию (local_data.brand_landing_pages.default_url)

  • Причина. В записи local_data.brand_landing_pages отсутствует default_url или это пустая строка.
  • Решение. Укажите действительный резервный URL целевой страницы с протоколом HTTP/HTTPS для пользователей, чье местоположение не соответствует локализованным URL.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com"
      }
    ]
  }
}

14. Отсутствует URL локализованной целевой страницы бренда (local_data.brand_landing_pages.localized_landing_pages.url)

  • Причина. В элементе внутри localized_landing_pages отсутствует или не заполнено поле url.
  • Решение. Укажите действительный полный URL локализованной целевой страницы с протоколом HTTP или HTTPS.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

15. Отсутствует локализованная целевая страница бренда (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Причина. В элементе внутри localized_landing_pages отсутствует или не заполнено поле locales.
  • Решение. Укажите хотя бы один действительный код языка или региона по стандарту BCP 47 (например, ["en-US"]) в массиве locales.
{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en",
            "locales": ["en-US", "en-GB"]
          }
        ]
      }
    ]
  }
}

Превышено максимальное количество изображений.

Код проблемы: EXCEEDED_MAX_COUNT
Серьезность: предупреждение
Можно подать апелляцию: нет (исправьте полезную нагрузку фида)

Эта ошибка возникает, когда полезная нагрузка объекта инфраструктуры содержит более 5 объектов изображений в массиве images.

Решение:

  • Обрежьте массив images так, чтобы он содержал не более пяти высококачественных репрезентативных фотографий местного объекта.
  • Изображения, превышающие лимит в 5 штук, будут удалены.

Недопустимые географические координаты.

Код проблемы: INVALID_LATLNG
Серьезность: ошибка (показ заблокирован).
Можно ли подать апелляцию: нет (проблема решается обновлением полезной нагрузки фида).

Эта ошибка возникает, когда географические координаты, указанные в полях location.latitude или location.longitude, выходят за допустимые сферические границы или представляют собой незаполненные нулевые координаты.

Распространенные причины и способы устранения:

  • Недопустимое значение широты. Широта должна быть числом с плавающей запятой в диапазоне от -90.0 до 90.0 включительно.
  • Долгота за пределами допустимого диапазона. Долгота должна быть числом с плавающей запятой в диапазоне от -180.0 до 180.0 включительно.
  • Нулевой остров (0,0). Если вы укажете 0.0, 0.0 или целые числа-плейсхолдеры (например, 999, 999), координаты будут отклонены.
  • Перепутанные координаты. Убедитесь, что широта и долгота не перепутаны в конвейере сериализации.

Пример допустимой полезной нагрузки:

{
  "location": {
    "latitude": 37.422,
    "longitude": -122.084
  }
}

Неверный формат или недопустимый URL.

Код проблемы: INVALID_ATTRIBUTE_VALUE
Серьезность: ошибка (показ заблокирован).
Можно ли подать апелляцию: нет (проблема решается обновлением полезной нагрузки фида).

Эта ошибка возникает, когда значение атрибута не проходит проверку схемы. Чаще всего это происходит, если URL целевой страницы партнера или URL изображения синтаксически недействителен.

Требования:

  • Протокол. В URL должен быть явно указан протокол http:// или https:// (настоятельно рекомендуется использовать HTTPS).
  • Кодировка. URL, содержащие специальные символы, пробелы или символы, не входящие в набор ASCII, должны быть закодированы с использованием процента (RFC 3986).
  • Канонический домен. Убедитесь, что домен указан полностью (например, https://example.com/local/123, а не example.com/local/123 или www.example).

Пример допустимой полезной нагрузки:

{
  "url": "https://www.tastybitestest.com/en"
}

Недействительное или недоступное изображение

Код проблемы: INVALID_IMAGE
Серьезность: предупреждение
Можно подать апелляцию: нет (исправьте полезную нагрузку фида)

Это предупреждение появляется на этапе асинхронного получения изображений, когда поисковый робот Google не может скачать, декодировать или проверить медиаобъект из image.url. Недействительное изображение не будет показываться, но объект недвижимости по-прежнему будет допущен к показу.

Распространенные причины и способы устранения:

  • Ошибки HTTP (404, 403, 500). URL изображения возвращает код статуса HTTP, отличный от 200. Убедитесь, что изображения общедоступны и для их просмотра не требуется аутентификация, согласие на использование файлов cookie или добавление IP-адреса в белый список.
  • Блокировка в файле robots.txt. Убедитесь, что ваша сеть доставки контента (CDN) разрешает доступ агентам пользователя Googlebot и Googlebot-Image.
  • Неподдерживаемый формат файла. Изображения должны быть в стандартных растровых форматах (JPEG, PNG, WebP). Анимированные GIF-файлы, SVG и необработанные форматы камеры не поддерживаются. Подробнее о правилах в отношении изображений…
  • Сбои SSL-сертификата. Убедитесь, что у сервера, на котором размещены изображения, есть действительная цепочка SSL-сертификатов.

Повторяющийся идентификатор объекта инфраструктуры

Код проблемы: DUPLICATE_ENTITY
Серьезность: ошибка (показ заблокирован).
Можно ли подать апелляцию: нет (проблема решается обновлением полезной нагрузки фида).

Эта ошибка возникает, когда одна и та же строка poi_id встречается в наборе файлов фида несколько раз.

Решение:

  • Убедитесь, что у каждого местного предложения в фиде есть уникальный детерминированный идентификатор poi_id.
  • Если в местном объекте недвижимости есть несколько типов номеров или тарифов, объедините их в один корневой объект инфраструктуры, а не создавайте дублирующиеся записи объектов с одинаковыми идентификаторами.

Дублировать сопоставленный объект

Код проблемы: DUPLICATE_MATCHED_ENTITY
Серьезность: ошибка (показ заблокирован).
Можно подать апелляцию: нет (исправьте полезную нагрузку фида или воспользуйтесь инструментами сопоставления объектов инфраструктуры).

Эта ошибка возникает, когда две или более записи poi_id в фиде соответствуют одному и тому же каноническому месту на Google Картах. Если несколько компаний сопоставлены с одним и тем же объектом Google, показ всех конфликтующих записей блокируется до устранения дублирования.

Как устранить проблему

  1. Определите конфликтующие свойства. Откройте Ingestion Viewer (Перенос > История), выберите последний запуск переноса и разверните панель Проверки. Нажмите на строку DUPLICATE_MATCHED_ENTITY с тем же идентификатором группы Issue Info, чтобы посмотреть все записи poi_id, сопоставленные с одним и тем же объектом Google.
  2. Удалите повторяющиеся адреса из фида. Если конфликтующие записи poi_id представляют один и тот же адрес, удалите повторяющиеся записи из фида, чтобы для этого адреса отправлялась только одна запись poi_id.
  3. Исправьте неверные сопоставления для независимых компаний. Если конфликтующие записи poi_id представляют собой отдельные независимые компании, которые были неправильно сопоставлены с одним и тем же объектом Google, откройте неправильно сопоставленную компанию в режиме просмотра ассортимента и нажмите Изменить сопоставление, чтобы выбрать или предложить специальное место на Google Картах. Подробные инструкции вы найдете в руководстве по сопоставлению объектов.

Несопоставленный объект

Код проблемы: UNMATCHED_ENTITY
Серьезность: ошибка (показ заблокирован)
Можно подать апелляцию: нет (используйте инструменты сопоставления объектов инфраструктуры или исправьте метаданные объекта)

Эта проблема означает, что конвейер сопоставления Google не смог сопоставить вашу местную компанию с каноническим местом в Google Картах.

Как устранить проблему

  1. Проверьте основные атрибуты. Убедитесь, что атрибуты name, display_address, location.address, url, telephone и location.latitude/location.longitude точно отражают физическое местоположение объекта.
  2. Проверьте информацию о совпадениях. Посмотрите столбец Информация о совпадениях в представлении инвентаря, чтобы увидеть места-кандидаты.
  3. Используйте инструмент исправления сопоставления объектов инфраструктуры. Нажмите Изменить сопоставление в Центре действий, чтобы вручную найти и подтвердить правильный идентификатор места в Google. Подробные инструкции можно найти в руководстве по сопоставлению объектов.

Нарушение правил Google Поиска в отношении изображений

Код проблемы: SAFE_SEARCH_POLICY_VIOLATION_IMAGE
Серьезность: ОШИБКА (показ заблокирован)
Можно подать апелляцию: да

Коды нарушений правил: правила в отношении контента в Google Поиске image Policy

Если вы считаете, что изображение было помечено по ошибке (ложное срабатывание), нажмите Подать апелляцию на панели "Сведения о проблеме".

Нарушение правил Google Поиска в отношении текстового контента – название

Код проблемы: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Серьезность: зависит от поля (см. подробности ниже)
Затронутое поле: name.localizations.*.text
Можно подать апелляцию: да (только для ошибок в региональных настройках по умолчанию); нет (для предупреждений в региональных настройках не по умолчанию)

  • Региональные настройки по умолчанию (name.default_locale): ОШИБКА (показ заблокирован). Показ всего объекта инфраструктуры будет заблокирован. Если вы считаете, что название региональных настроек по умолчанию было помечено по ошибке (ложное срабатывание), нажмите Подать апелляцию на панели "Сведения о проблеме".
  • Нестандартный региональный параметр: предупреждение (показ не блокируется). Будет удалена только помеченная локализация, а сам объект инфраструктуры по-прежнему будет показываться. Предупреждения, связанные с региональными настройками, которые не используются по умолчанию, нельзя обжаловать. Чтобы устранить проблему, обновите полезную нагрузку фида.

Коды нарушений правил: правила в отношении текстового контента в Google Поиске.

Нарушение правил Google Поиска в отношении текстового контента – описание

Код проблемы: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Серьезность: предупреждение (не блокирует показ)
Затронутое поле: description.localizations.*.text
Можно ли подать апелляцию: нет (необходимо обновить полезную нагрузку фида)

Это предупреждение появляется, когда текстовая копия в description.localizations нарушает правила Google Поиска в отношении текстового контента. Если локализованное описание (или все поле description, если помечено описание на языке по умолчанию) не показывается, объект инфраструктуры все равно может быть показан.

Коды нарушений правил: правила в отношении текстового контента в Google Поиске.

Нарушение правил в отношении текстового контента в Google Поиске – отображаемый адрес

Код проблемы: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Серьезность: предупреждение (не блокирует показ)
Затронутое поле: display_address.localizations.*.text
Можно ли подать апелляцию: нет (необходимо обновить полезную нагрузку фида)

Это предупреждение появляется, если отформатированный текст адреса в свойстве display_address.localizations содержит контент, запрещенный правилами Google Поиска в отношении текстового контента. Если помечена локализация адреса (или все поле display_address, если помечена локаль по умолчанию), то она не используется, но объект инфраструктуры по-прежнему может показываться.

Коды нарушений правил: правила в отношении текстового контента в Google Поиске.

Время открытия компании позже времени закрытия.

Код проблемы: NOT_LESS_THAN_FIELD
Серьезность: ошибка (показ заблокирован)
Затронутые поля: local_data.business_hours.time_ranges.open_time, local_data.business_hours.time_ranges.close_time
Можно ли подать апелляцию: нет (чтобы устранить проблему, обновите полезную нагрузку фида)

Эта ошибка возникает, если время открытия open_time позже или равно времени закрытия close_time в один и тот же день.

Распространенные причины и способы устранения:

  • Инверсия в тот же день. Убедитесь, что значение open_time меньше, чем close_time (например, 09:00 и 17:00).
  • Ночные смены. Если заведение открывается в один день, а закрывается после полуночи на следующий день (например, работает с 21:00 до 02:00), в качестве значения close_day укажите следующий день (например, open_day: "FRIDAY", close_day: "SATURDAY").

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "business_hours": {
      "time_ranges": [
        {
          "open_day": "MONDAY",
          "open_time": { "hours": 9, "minutes": 0 },
          "close_day": "MONDAY",
          "close_time": { "hours": 17, "minutes": 0 }
        }
      ]
    }
  }
}

Минимальное значение диапазона цен больше максимального.

Код проблемы: INVALID_PRICE_RANGE
Серьезность: ошибка (показ заблокирован)
Затронутые поля: local_data.price_range.min_price, local_data.price_range.max_price
Можно ли подать апелляцию: нет (чтобы устранить проблему, обновите полезную нагрузку фида)

Эта ошибка возникает, если значение min_price превышает значение max_price или если в min_price и max_price указаны разные коды валют.

Распространенные причины и способы устранения:

  • Перевернутые значения. Убедитесь, что значение min_price меньше или равно значению max_price.
  • Несоответствие валют. Убедитесь, что в min_price.currency_code и max_price.currency_code указан один и тот же трехбуквенный код валюты по стандарту ISO 4217 (например, "USD").

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "price_range": {
      "min_price": {
        "currency_code": "USD",
        "units": 15,
        "nanos": 0
      },
      "max_price": {
        "currency_code": "USD",
        "units": 45,
        "nanos": 0
      }
    }
  }
}

Повторяющееся уникальное свойство в объекте инфраструктуры

Код проблемы: DUPLICATE_UNIQUE_PROPERTY
Серьезность: ошибка (показ заблокирован).
Можно ли подать апелляцию: нет (проблема решается обновлением полезной нагрузки фида).

Эта ошибка возникает, когда поле или дочерний элемент, которые должны быть уникальными для одного объекта инфраструктуры, содержат повторяющиеся записи.

Чтобы узнать, какое свойство нарушает уникальность, проверьте панель "Сведения о проблеме".

1. Повторяющийся идентификатор бренда в объекте инфраструктуры (local_data.brand_landing_pages.brand_id)

  • Причина. Одна и та же строка brand_id указана в нескольких записях brand_landing_pages для одного объекта инфраструктуры.
  • Решение. Объедините все целевые страницы бренда в один объект brand_landing_pages.

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722"
      },
      {
        "brand_id": "brand_opentable",
        "default_url": "https://www.opentable.com/r/287722"
      }
    ]
  }
}

2. Повторяющийся URL локализованной целевой страницы бренда (local_data.brand_landing_pages.localized_landing_pages.url)

  • Причина. Один и тот же URL целевой страницы указан несколько раз в атрибуте localized_landing_pages для одного бренда.
  • Решение. Убедитесь, что каждый URL уникален, или свяжите несколько регионов с одним URL в массиве locales.

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

3. Повторяющийся атрибут "локализованная целевая страница бренда" [brand_localized_landing_page_locale] (local_data.brand_landing_pages.localized_landing_pages.locales)

  • Причина. Один и тот же код региона (например, "en-US") повторяется в нескольких записях в localized_landing_pages для одного и того же бренда.
  • Решение. Назначьте каждый тег региона только одной локализованной целевой странице.

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "brand_zenchef",
        "default_url": "https://bookings.zenchef.com/results?rid=287722",
        "localized_landing_pages": [
          {
            "url": "https://bookings.zenchef.com/en/results?rid=287722",
            "locales": ["en-US", "en-GB"]
          },
          {
            "url": "https://bookings.zenchef.com/fr/results?rid=287722",
            "locales": ["fr-FR"]
          }
        ]
      }
    ]
  }
}

Недопустимый URL бренда или неверный формат URL.

Код проблемы: INVALID_ATTRIBUTE_VALUE
Серьезность: ошибка (показ заблокирован)
Можно подать апелляцию: нет (исправьте полезную нагрузку фида)
Затронутые поля: local_data.brand_landing_pages.default_url, local_data.brand_landing_pages.localized_landing_pages.url

Эта ошибка возникает, когда URL целевой страницы по умолчанию или локализованной целевой страницы не проходит проверку синтаксиса URI.

Требования:

  • Протокол. Необходимо явно указать http:// или https:// (для показа рекламы требуется https://).
  • Синтаксис. URL должен быть действительным, закодированным в процентах, соответствующим стандарту RFC 3986 и содержать полное доменное имя.

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "brand_landing_pages": [
      {
        "brand_id": "tasty_bites_brand",
        "default_url": "https://www.tastybitestest.com/en",
        "localized_landing_pages": [
          {
            "url": "https://www.tastybitestest.com/en/reservation",
            "locales": ["en-US"]
          }
        ]
      }
    ]
  }
}

Нарушение правил в отношении текстового контента в Google Поиске – категория заведения

Код проблемы: SAFE_SEARCH_POLICY_VIOLATION_TEXT
Серьезность: предупреждение (не блокирует показ).
Можно подать апелляцию: нет (устраните проблему, обновив полезную нагрузку фида).
Затронутое поле: local_data.establishment_category.localizations.*.text

Это предупреждение появляется, когда локализованный текст категории заведения не проходит автоматическую проверку фильтрами контента Безопасного поиска. Если локализация категории заведения помечена (или помечено все поле establishment_category, если помечена локаль по умолчанию), она опускается, но объект инфраструктуры по-прежнему может показываться.

Решение:

Пример допустимой полезной нагрузки:

{
  "local_data": {
    "establishment_category": {
      "default_locale": "en",
      "localizations": [
        {
          "locale": "en",
          "text": "Restaurant"
        },
        {
          "locale": "fr",
          "text": "Restaurant gastronomique"
        }
      ]
    }
  }
}