- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Agrega operaciones al trabajo por lotes.
Lista de errores arrojados: AuthenticationError AuthorizationError BatchJobError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError
Solicitud HTTP
POST https://googleads.googleapis.com/v15/{resourceName=customers/*/batchJobs/*}:addOperations
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
resourceName |
Obligatorio. El nombre del recurso del trabajo por lotes. |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{
"sequenceToken": string,
"mutateOperations": [
{
object ( |
Campos | |
---|---|
sequenceToken |
Un token que se usa para aplicar la secuencia. La primera solicitud de batchJobs.addOperations para un trabajo por lotes no debe establecer este token. Las solicitudes posteriores deben establecer secuenciaToken con el valor de nextSequenceToken recibido en la respuesta batchJobs.addOperations anterior. |
mutateOperations[] |
Obligatorio. La lista de mutaciones que se agregan. Las operaciones pueden usar números enteros negativos como IDs temporales para indicar dependencias entre entidades creadas en este trabajo por lotes. Por ejemplo, un cliente con el ID = 1234 puede crear una campaña y un grupo de anuncios en esa misma campaña. Para ello, debe crear una campaña en la primera operación con el nombre del recurso configurado explícitamente como "customers/1234/campaigns/-1" y la creación de un grupo de anuncios en la segunda operación con el campo de campaña también establecido en "customers/1234/campaigns/-1". |
Cuerpo de la respuesta
Mensaje de respuesta para BatchJobService.AddBatchJobOperations
.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
Representación JSON |
---|
{ "totalOperations": string, "nextSequenceToken": string } |
Campos | |
---|---|
totalOperations |
La cantidad total de operaciones agregadas hasta el momento para este trabajo por lotes. |
nextSequenceToken |
El token de secuencia que se utilizará cuando se vuelva a llamar a batchJobs.addOperations, si se deben agregar más operaciones. La siguiente solicitud batchJobs.addOperations debe establecer el campo secuenciaToken con el valor de este campo. |
Permisos de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/adwords
Para obtener más información, consulta la Descripción general de OAuth 2.0.