Method: customers.batchJobs.mutate

Ändert einen Batchjob.

Liste der ausgegebenen Fehler: AuthenticationError AuthorizationError HeaderError InternalError QuotaError RequestError ResourceCountLimitExceededError

HTTP-Anfrage

POST https://googleads.googleapis.com/v17/customers/{customerId}/batchJobs:mutate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, für den ein Batch-Auftrag erstellt werden soll.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "operation": {
    object (BatchJobOperation)
  }
}
Felder
operation

object (BatchJobOperation)

Erforderlich. Der Vorgang, der für einen einzelnen Batchjob ausgeführt werden soll.

Antworttext

Antwortnachricht für BatchJobService.MutateBatchJob.

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

JSON-Darstellung 
{
  "result": {
    object (MutateBatchJobResult)
  }
}
Felder
result

object (MutateBatchJobResult)

Das Ergebnis für mutate.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/adwords

Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.

BatchJobOperation

Ein einzelner Vorgang bei einem Batchjob.

JSON-Darstellung 
{

  // Union field operation can be only one of the following:
  "create": {
    object (BatchJob)
  },
  "remove": string
  // End of list of possible types for union field operation.
}
Felder
Union-Feld operation. Der mutate-Vorgang Für operation ist nur einer der folgenden Werte zulässig:
create

object (BatchJob)

Erstellungsvorgang: Für den neuen Batchjob wird kein Ressourcenname erwartet.
remove

string

Entfernen: Der Batch-Auftrag darf nicht ausgeführt worden sein. Für den entfernten Batchjob wird ein Ressourcenname im folgenden Format erwartet:

customers/{customerId}/batchJobs/{batch_job_id}

MutateBatchJobResult

Das Ergebnis des Batch-Auftrags "mutate".

JSON-Darstellung 
{
  "resourceName": string
}
Felder
resourceName

string

Der Ressourcenname des Batchjobs.