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 de REST tradicional
ya que, en su lugar, usa métodos personalizados, como search y mutate,.
de los métodos list, get, create, update y delete más tradicionales.
Estas acciones se expresan en URLs de REST mediante la asignación HTTP
de una : para separar el verbo personalizado del resto de la URL.
Por ejemplo, una llamada a la API de modificación de campaña utiliza la siguiente URL:
Una de las razones por las que la API usa métodos personalizados es la habilitación de la agrupación en lotes de varios
operaciones en una sola solicitud a la API. Una semántica de REST estricta solo permitiría
actualizar una campaña a la vez. Una instancia de REST tradicional
update a una
campaña, por ejemplo, requeriría el envío de una solicitud PATCH HTTP por campaña
recurso.
Para permitir que se agrupen muchas operaciones en un solo cuerpo de solicitud,
En cambio, la API de Google Ads define un método mutate personalizado para la mayoría de los recursos.
De manera similar, para habilitar las lecturas por lotes (recuperar muchos objetos a la vez) de la API,
la API usa un método search personalizado con una consulta de Google Ads similar a SQL
Idioma.
En la página Métodos comunes, se detalla la siguiente información:
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: 2024-08-22 (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."]]],[]]
