Présentation de l'interface REST

Point clé : Nous vous recommandons vivement d'utiliser nos bibliothèques clientes officielles dans la mesure du possible. Toutes les bibliothèques clientes fournies par Google sont implémentées à l'aide de gRPC, à l'exception de la bibliothèque Perl, qui utilise l'interface REST. Sauf si vous recherchez spécifiquement des informations sur REST, consultez la documentation de référence pour en savoir plus sur nos bibliothèques clientes officielles et la couche de transport REST.

Remarque : Si vous débutez avec l'API Google Ads, nous vous recommandons de lire d'abord le guide de démarrage, qui explique comment configurer votre compte et effectuer votre premier appel d'API. Veillez à suivre l'onglet curl.

L'API Google Ads peut être appelée à l'aide de gRPC ou de REST. Les deux interfaces exposent une conception orientée ressources partagée avec d'autres API Google Cloud.

Nous vous recommandons d'utiliser les bibliothèques clientes officielles de Google dans la mesure du possible. Elles fournissent un code idiomatique et de sûreté du typage dans chaque langage compatible, et gèrent de nombreux détails de communication de bas niveau avec l'API (comme les paramètres de délai avant expiration, la pagination de l'ensemble de résultats et l'authentification). Nos bibliothèques clientes incluent également un ensemble complet d'exemples de code et d'utilitaires qui facilitent les tâches courantes, telles que la construction de noms de ressources et la gestion des masques de champ.

Ce guide présente des détails spécifiques à REST et explique ce que vous devez savoir pour appeler l'interface REST directement, sans utiliser de bibliothèque cliente compatible avec Google. Ce guide peut vous être utile si vous écrivez votre propre code personnalisé pour utiliser REST directement ou si vous utilisez une bibliothèque cliente HTTP tierce.