В этом документе представлены рекомендации по передовому опыту. Дополнительные сведения см. в разделе Советы по производительности .
Когда использовать API
Отправка запросов программно
Независимо от того, предпочитаете ли вы автоматизировать каждую часть своего рабочего процесса или подключиться к своей системе ERP (планирование ресурсов предприятия), Content API позволяет вам отправлять обновления, как только ваши запасы изменятся.
Чтобы получить немедленную обратную связь
В Content API вы получаете ответ на каждый запрос мгновенно, а не через сводку по электронной почте после обработки каналов данных. Для больших пакетных запросов ожидается задержка от пяти до десяти секунд.
Чтобы часто менять данные о продукте
С помощью Content API вы можете вносить дополнительные обновления в свой быстро меняющийся ассортимент продуктов много раз в день, тогда как отправка всего потока данных каждый раз невозможна. Если обновления становятся доступными по отдельности, отправляйте их по отдельности, не ждите, пока появится несколько обновлений, чтобы можно было объединить их в пакет. Аналогично, если обновления доступны пакетами, отправляйте их пакетами, не разбивая их на отдельные запросы.
Для управления несколькими субаккаунтами
Вновь созданные аккаунты Merchant Center представляют собой отдельные аккаунты, в которых хранится собственный набор данных о товарах. В большинстве случаев это работает хорошо, но по мере роста вашей учетной записи вы можете обнаружить, что вам нужна более сложная система управления вашими продуктами. Если это ваш случай, рассмотрите возможность использования многоклиентской учетной записи или MCA. Управление учетной записью MCA на уровне API может осуществляться через службу учетных записей и позволяет программно добавлять и управлять дополнительными учетными записями. Более подробную информацию о том, как получить учетную запись MCA, можно найти здесь .
Как использовать API
Не используйте API, как если бы вы использовали каналы данных.
Избегайте ежедневных обновлений всей ленты продуктов при использовании ресурса products . Вместо этого специально обновляйте только те продукты, данные которых действительно изменились. Отправка всего фида данных через ресурс products требует больше времени и ресурсов как для Google, так и для вас.
Не используйте API для регулярного получения загруженной вами информации о продукте.
Если вы несете ответственность за хранение информации о продукте в определенной учетной записи Merchant Center, избегайте регулярного запроса информации о продукте из Content API с помощью методов products.get или products.list . Для клиентов, загружающих информацию, эти методы могут помочь в устранении проблем при разработке решений, использующих Content API. Однако они не предназначены для регулярного получения информации о продуктах такими клиентами. У вас должен быть другой источник информации о товарах, например локальная база данных товаров, и товары в Merchant Center должны отражать содержимое этого источника.
Не используйте одновременно фиды данных и Content API для отправки товаров.
Если вы планируете перейти на API для отправки товаров, убедитесь, что вы больше не используете каналы данных для отправки товаров. Если вы продолжите отправлять элементы на обоих носителях, могут возникнуть неожиданные результаты.
Есть ли способ безопасно использовать API и каналы данных вместе?
Вы можете манипулировать своими фидами данных с помощью службы Datafeed API. Хотя это значительно упростит управление фидами данных в масштабе, имейте в виду, что вам не следует вставлять или обновлять продукты с помощью API одновременно с фидами, поскольку могут возникнуть непредвиденные результаты.
Вот некоторые другие примеры приемлемых способов совместного использования каналов и API:
Выполнение запросов только для чтения (получение или список) из API: некоторые продавцы хотят использовать API для получения информации и обновлений статуса своих продуктов. Это приемлемо, поскольку информация о продукте обновляется только через каналы.
Использование API для управления вашими дополнительными учетными записями ( Служба учетных записей ) и/или настройками налогов и доставки на уровне учетной записи ( Служба Accounttax и Служба настроек доставки ). Это не функции, которые могут предоставлять каналы данных, поэтому нет конфликта с использованием API для управления этими функциями.
Как перейти от использования каналов данных к использованию только API или наоборот?
Если вы в настоящее время используете фиды данных и хотите переключиться на использование только API для обновления продуктов, вам необходимо повторно загрузить данные о ваших продуктах с помощью API. Когда вы используете службу продуктов для обновления определенного продукта, API берет на себя управление информацией о продукте, и удаление продукта из фида данных или удаление самого фида данных больше не приведет к удалению информации о продукте из вашей учетной записи Merchant Center. Убедитесь, что нет обновлений фида данных, если вы хотите удалить продукт из фида данных или сам фид данных, иначе фид данных снова станет владельцем, и удаление продукта из фида данных приведет к удалению продукта.
Если в настоящее время вы используете только API для получения информации о продуктах и хотите использовать фиды данных в качестве основного источника информации о продуктах, вы можете просто добавить новый фид данных в свою учетную запись Merchant Center, и они станут владельцами перечисленных продуктов. Если есть продукты, которые вы хотите удалить до истечения срока их действия и которые были загружены исключительно через API, вам необходимо удалить их либо через Merchant Center, либо через API.
Как настроить таргетинг продуктов на несколько стран с помощью Content API for Shopping?
Чтобы настроить таргетинг на несколько стран для рекламы и бесплатных предложений продуктов, представленных через Content API, настройте дополнительные страны в основном фиде Content API в Merchant Center или добавьте эти дополнительные страны через поле shipping на ресурсе products .
Ниже приведен пример изменения настроек основного фида Content API.
Дополнительную информацию см. в разделе Таргетинг товарных объявлений и бесплатных объявлений в нескольких странах .
Убедитесь, что ваши клиентские библиотеки обновлены.
Если вы используете клиентскую библиотеку Google для взаимодействия с Content API, обязательно используйте менеджер пакетов для выбранного вами языка программирования и убедитесь, что версия библиотеки обновлена. Дополнительные сведения см. в руководстве разработчика для выбранного вами языка в разделе «Примеры и библиотеки» .
Обязательно используйте атрибуты мест назначения, чтобы контролировать, какие продукты появляются в различных программах покупок.
Content API автоматически принимает настройки по умолчанию для вашего фида Content API, настроенные в Merchant Center. Вы можете использовать атрибуты продукта includedDestinations или excludedDestinations для управления участием в программе на уровне продукта в фиде или через Content API.
Если ваш фид API включен в программу, например «Купить через Google» (ранее известная как «Shopping Actions»), но вы хотите исключить определенные продукты, используйте атрибут excludedDestinations и укажите в качестве значения Shopping Actions . При условии отсутствия ошибок настройки фида по умолчанию в Merchant Center будут перезаписаны, и этот конкретный товар не будет отображаться в программе "Купить через Google" (ранее известной как Shopping Actions). И наоборот, если ваш фид не включен в программу, например «Покупки», вы можете включить отдельные элементы, используя атрибут includedDestinations и Shopping_ads в качестве значения, и этот элемент будет отображаться в товарных объявлениях.
Дополнительную информацию об атрибутах продукта includedDestinations и excludedDestinations см. в Справочном центре .
Обязательно обновляйте элементы до истечения срока их действия.
Если элемент не изменяется до истечения срока его действия, через 30 дней после последнего обновления или в указанную дату истечения срока действия, если раньше, обновите элемент, чтобы избежать его деактивации. Если вам необходимо обновить множество элементов, поскольку ни один из них не изменился или вы не можете отследить, когда они обновлялись в последний раз, не обновляйте все элементы одновременно, а распределите нагрузку равномерно на несколько дней.
Не удаляйте фид Content API, иначе ваши продукты могут исчезнуть.
При первой загрузке продукта с помощью channel:online через Content API в Merchant Center появится новый фид под названием Content API . При первой загрузке продукта с помощью channel:local через Content API в Merchant Center появится новый фид под названием Content API с подзаголовком Local Products . Убедитесь, что вы случайно не удалили онлайн- или локальный канал Content API. В зависимости от удаленного вами фида будут удалены онлайн-или местные товары, которые вы добавили в Merchant Center через Content API.
Пакетная обработка нескольких запросов к одной и той же службе с использованием метода custombatch.
Вместо выполнения множества последовательных или параллельных запросов к одной и той же службе создайте один специальный пакетный запрос, содержащий все нужные запросы. Таким образом, задержка при выполнении запросов к конечной точке API возникает только один раз для вызова пользовательского пакета, а не для каждого отдельного запроса, что особенно важно, если вы выполняете последовательные запросы.
Не отправляйте несколько обновлений для одного элемента в одном пакете.
Это даст неожиданные результаты из-за неопределенности относительно последовательности обновлений и может вызвать конфликтную ошибку .
Не отправлять обновления для неизмененных элементов
Обязательно отправляйте запросы только на новые, измененные или удаленные товары, если в противном случае срок действия товаров не истечет.
Используйте дополнительные фиды, если цены и/или доступность быстро меняются.
Если у вас возникли проблемы с поддержанием актуальности информации о цене, наличии или продажах продукта, рассмотрите возможность использования дополнительных фидов в ресурсе products , чтобы отправлять обновления только для этих атрибутов. Поскольку дополнительные обновления фида невелики, вы можете сделать гораздо больше дополнительных обновлений фида за определенный период, чем полные обновления продуктов, что поможет поддерживать цены и доступность ваших продуктов в соответствии с вашими целевыми страницами.
Другой способ обновления цены и наличия товара — использование автоматического обновления товара . Это можно использовать в дополнение к обновлениям API, чтобы избежать несоответствий между информацией в Merchant Center и информацией на целевых страницах продуктов. Однако имейте в виду, что это предназначено для устранения небольших проблем с ценой и доступностью продуктов, поэтому автоматические обновления товаров не заменяют предоставление правильной информации через API.
Когда использовать токен обновления
Токен обновления возвращается в HTTP-заголовке запросов авторизации. Он содержит много другой информации, связанной с аутентификацией, но токен обновления часто является той частью, которую разработчики хотят получить в свои руки, поскольку он устраняет необходимость неоднократно запрашивать у пользователя аутентификацию, поскольку токены доступа действуют только 60 минут до истечения срока действия.