Обзор интерфейса REST

Важный момент: Мы настоятельно рекомендуем использовать наши официальные клиентские библиотеки везде, где это возможно. Все клиентские библиотеки, предоставленные Google, реализованы с использованием gRPC, за исключением библиотеки Perl , которая использует интерфейс REST. Если вам не нужна конкретная информация о REST, обратитесь к справочной документации , где описаны как наши официальные клиентские библиотеки, так и транспортный уровень REST.

Примечание: Если вы новичок в Google Ads API, рекомендуем сначала ознакомиться с руководством по началу работы , в котором описано, как настроить учетную запись и выполнить первый вызов API. Обязательно перейдите во вкладку curl .

Вызов API Google Ads возможен как с использованием gRPC , так и REST. Оба интерфейса используют ресурсоориентированную архитектуру, общую с другими API Google Cloud.

Мы рекомендуем по возможности использовать официальные клиентские библиотеки Google. Они предоставляют идиоматический, типобезопасный код на каждом поддерживаемом языке и обрабатывают многие низкоуровневые детали взаимодействия с API (например, настройки тайм-аута, пагинацию набора результатов и аутентификацию ). Наши клиентские библиотеки также включают обширный набор примеров кода и утилит, которые помогают в решении распространенных задач, таких как формирование имен ресурсов и обработка масок полей .

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