Шаг 2. Каналы

Сначала вам нужно создать свои каналы, затем Google их оценивает.

Создание каналов

1. Создайте свой канал(ы). Большую часть данных о ваших запасах вы передаете в Google через фиды. Для начала создайте фид продавцов (и фид услуг, если применимо):

   • Лента продавцов. В ленте «Продавцы» описаны ваши продавцы и ссылки на действия на уровне продавца.
   • Лента услуг (необязательно/не рекомендуется) . Не рекомендуется внедрять каналы услуг для новых интеграций Appointments Business Link. Если вы хотите сохранить существующую интеграцию, следуйте этой устаревшей документации .

   Обязательные и рекомендуемые поля

   Кормить	Имя поля	Описание	Необходимый?
   Торговец	trade_id	Уникальный идентификатор продавца	Да
   Торговец	имя	Имя продавца	Да
   Торговец	гео	Адрес и геокоординаты продавца	Да
   Торговец	телефон	Телефон торговца	Да
   Торговец	категория	Тип места продавца	Приятно иметь
   Торговец	action_link	Информация о ссылках на контент, специфичных для продавцов	Да
   Торговец	action_link_type
   Торговец	идентификатор бренда	Строка, определяющая используемый бренд, ориентированный на потребителя.	Необязательный

   Примечание. Все дополнительные поля, указанные в справочном разделе, следует игнорировать.
   Ключевой момент: вам необходимо только загрузить фид продавца.

   Для начала ознакомьтесь с образцами фидов

   • Ленты личных встреч

   Подробнее об указании ссылок на действия в каналах интеграции Appointments Business Link можно узнать здесь .

   Включите метаданные фида в каждый из ваших фидов, которые инструктируют Google о том, как интерпретировать фид.

   Ниже приведен фрагмент метаданных фида:

   "metadata": {
    "generation_timestamp": "1467993600",
    "processing_instruction": "PROCESS_AS_COMPLETE",
    "total_shards": 1
   }

   Примечание. Все каналы необходимо загружать с помощью инструкции обработки PROCESS_AS_COMPLETE. PROCESS_AS_INCREMENTAL устарел и не может использоваться.
   Примечание. Эту интеграцию также можно реализовать вместе со сквозной интеграцией Центра действий или в качестве дополнения к сквозной интеграции. Для поддержки этого вам также потребуется реализовать каналы доступности и обязательные поля сквозной интеграции в соответствии с этим руководством .

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

   Если вы действительно хотите продолжить работу с форматом pb3, общую информацию о том, как использовать буферы протокола для создания файла pb3, см. в разделе «Основы буфера протокола: Java» .

3. Загрузите каналы в свой Dropbox SFTP. Чтобы загрузить свои каналы, используйте информацию о почтовом ящике SFTP , предоставленную вам Google, и закрытый ключ, который вы создали в программе «Настройка» . Сервер Google SFTP доступен по адресу sftp://partnerupload.google.com через порт 19321 .

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

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

   • Размер файлов фида и фрагментов:
     • Размер файла фида не должен превышать 200 МБ (после сжатия). Сжимаем их с помощью gzip
     • Если ваш файл может достигать размера более 200 МБ (после сжатия), разделите его на несколько фрагментов, следуя руководству по сегментированию файлов каналов . Однако сама по себе эта интеграция вряд ли позволит достичь предела в 200 МБ.
   • Частота полных обновлений:
     • Полная информация о торговцах предоставляется один раз в день.
     • (Если реализовано) Полная информация об услугах предоставляется один раз в день.
   Примечание. Google обрабатывает файлы фидов сразу после их загрузки в папку обмена SFTP. Если канал разбит на несколько файлов, процесс начинается после загрузки последнего файла. Если ваш фид содержит ошибки, вы получите электронное письмо с кодами ошибок фида .

Google оценивает каналы

После того как вы загружаете свои фиды, Google обрабатывает и оценивает их качество и полноту. Мы учитываем несколько факторов:

• Корма соответствуют заявленным характеристикам.
• Фиды включают все обязательные поля.
• У каждого продавца есть по крайней мере одна action_link или одна услуга, для которой определена хотя бы одна action_link .
• Большая часть ваших данных о продавцах совпадает с местоположениями на Картах Google.

Примечание. Чтобы обеспечить плавную интеграцию, перед отправкой фидов выполните предварительную оценку вышеуказанных факторов, за исключением последнего.