Precaución: Estás viendo la documentación de la interfaz REST de la API. La mayoría de nuestras bibliotecas cliente oficiales usan gRPC. Consulta la Introducción a REST para obtener más detalles.
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El diseño de la API de Google Ads difiere de una arquitectura REST tradicional porque usa principalmente métodos personalizados, como search y mutate,, en lugar de los métodos más tradicionales list, get, create, update y delete.
Estas acciones se expresan en URLs REST mediante la convención de asignación HTTP de un : para separar el verbo personalizado del resto de la URL.
Por ejemplo, una llamada a la API de mutación de campaña usa la siguiente URL:
Uno de los motivos por los que la API usa métodos personalizados es para habilitar el procesamiento por lotes de varias operaciones en una sola solicitud a la API. La semántica REST estricta solo permitiría actualizar una campaña a la vez. Por ejemplo, un update REST tradicional a una campaña requeriría el envío de una solicitud HTTP PATCH por recurso de campaña.
Para permitir que muchas operaciones se combinen en un solo cuerpo de solicitud, la API de Google Ads define un método mutate personalizado para la mayoría de los recursos.
Del mismo modo, para habilitar las lecturas por lotes (recuperación de muchos objetos a la vez) desde la API, esta usa un método search personalizado con un Lenguaje de consulta de Google Ads similar a SQL.
En la página Métodos comunes, se detallan los métodos más usados en la API de Google Ads.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-02-26 (UTC)"],[[["The Google Ads API utilizes custom methods like `search` and `mutate` instead of standard REST methods for efficiency and batch operations."],["This approach allows for updating multiple campaigns or fetching numerous objects within a single request, unlike traditional REST."],["Custom methods are expressed in REST URLs using a colon to separate the verb from the rest of the URL, for example, `https://googleads.googleapis.com/v18/customers/1234567890/campaigns:mutate`."],["Batching operations, like updating many campaigns simultaneously, are enabled through the custom `mutate` method, improving efficiency over individual requests."],["The `search` method uses a SQL-like query language for batch reads, enabling retrieval of multiple objects in one API call."]]],["The Google Ads API uses custom methods like `search` and `mutate` instead of standard REST methods (e.g., `list`, `get`). This is indicated in URLs by a `:` separator. `Mutate` enables batching multiple operations into one request, unlike standard `update`, which handles one campaign at a time. Similarly, `search` allows fetching multiple objects in a single request, utilizing a SQL-like query language. This deviates from REST conventions to facilitate efficient batch processing and querying.\n"]]
