Method: customers.googleAds.mutate

Erstellt, aktualisiert oder entfernt Ressourcen. Diese Methode unterstützt atomare Transaktionen mit mehreren Ressourcentypen. Sie können beispielsweise eine Kampagne und ein Kampagnenbudget in kleinstmöglichen Schritten erstellen oder bis zu tausende Mutationen in kleinstmöglichen Schritten durchführen.

Diese Methode ist im Wesentlichen ein Wrapper für eine Reihe von mutate-Methoden. Die einzigen Funktionen, die über den direkten Aufruf dieser Methoden angeboten werden, sind:

  • Atomare Transaktionen
  • Namen für temporäre Ressourcen (unten beschrieben)
  • Etwas geringere Latenz bei einer Reihe von mutate-Aufrufen

Hinweis: Es sind nur Ressourcen enthalten, die atomare Transaktionen unterstützen. Daher können mit dieser Methode nicht alle Aufrufe einzelner Dienste ersetzt werden.

Vorteile atomarer Transaktionen

Atomarität vereinfacht die Fehlerbehandlung erheblich. Wenn Sie eine Reihe von Änderungen vornehmen und eine davon fehlschlägt, kann dies zu Inkonsistenzen in Ihrem Konto führen. Bei der Atomarität erreichen Sie entweder den ausgewählten Status direkt oder die Anfrage schlägt fehl und Sie können es noch einmal versuchen.

Namen von temporären Ressourcen

Namen von temporären Ressourcen sind ein spezieller Ressourcennamen, mit dem eine Ressource erstellt und in derselben Anfrage auf diese Ressource verwiesen wird. Wenn beispielsweise ein Kampagnenbudget mit resourceName gleich customers/123/campaignBudgets/-1 erstellt wird, kann dieser Ressourcenname im Feld Campaign.budget in derselben Anfrage wiederverwendet werden. Auf diese Weise werden die beiden Ressourcen atomar erstellt und verknüpft.

Um einen temporären Ressourcennamen zu erstellen, geben Sie eine negative Zahl in den Teil des Namens ein, den der Server normalerweise zuweisen würde.

Hinweis:

  • Ressourcen müssen mit einem temporären Namen erstellt werden, bevor der Name wiederverwendet werden kann. Das vorherige Beispiel für CampaignBudget + Kampagne würde beispielsweise fehlschlagen, wenn die Änderung der Reihenfolge umgekehrt würde.
  • Temporäre Namen werden nicht für Anfragen gespeichert.
  • Die Anzahl der temporären Namen in einer Anfrage ist nicht begrenzt.
  • Jeder temporäre Name muss eine eindeutige negative Zahl enthalten, auch wenn sich die Ressourcentypen unterscheiden.

Latenz

Es ist wichtig, Änderungen nach Ressourcentyp zu gruppieren, da andernfalls bei der Anfrage eine Zeitüberschreitung auftreten und Fehler auftreten können. Die Latenz entspricht in etwa einer Reihe von Aufrufen einzelner mutate-Methoden, wobei jede Änderung des Ressourcentyps ein neuer Aufruf ist. Wenn Sie beispielsweise 10 Kampagnen und dann 10 Anzeigengruppen bearbeiten, ist das wie zwei Anrufe, während das Ändern von 1 Kampagne, 1 Anzeigengruppe, 1 Kampagne und 1 Anzeigengruppe wie 4 Anrufe entspricht.

{33CampaignError1Fehler}AuthenticationErrorAuthorizationErrorBiddingErrorCampaignBudgetErrorCampaignCriterionErrorCampaignErrorCampaignExperimentErrorCampaignSharedSetErrorCollectionSizeErrorContextErrorConversionActionErrorCriterionErrorCustomerFeedErrorDatabaseErrorDateErrorDateRangeErrorDistinctErrorExtensionFeedItemErrorExtensionSettingErrorFeedAttributeReferenceErrorFeedErrorFeedItemErrorFeedItemSetErrorFieldErrorFieldMaskErrorFunctionParsingErrorHeaderErrorImageErrorInternalErrorKeywordPlanAdGroupKeywordErrorKeywordPlanCampaignErrorKeywordPlanErrorLabelErrorListOperationErrorMediaUploadErrorMutateErrorNewResourceCreationErrorNullErrorOperationAccessDeniedErrorPolicyFindingErrorPolicyViolationErrorQuotaErrorRangeErrorRequestErrorResourceCountLimitExceededErrorSettingErrorSharedSetErrorSizeLimitErrorStringFormatErrorStringLengthErrorUrlFieldErrorUserListErrorYoutubeVideoRegistrationError

HTTP-Anfrage

POST https://googleads.googleapis.com/v14/customers/{customerId}/googleAds:mutate

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
customerId

string

Erforderlich. Die ID des Kunden, dessen Ressourcen geändert werden.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "mutateOperations": [
    {
      object (MutateOperation)
    }
  ],
  "partialFailure": boolean,
  "validateOnly": boolean,
  "responseContentType": enum (ResponseContentType)
}
Felder
mutateOperations[]

object (MutateOperation)

Erforderlich. Die Liste der Vorgänge, die für einzelne Ressourcen ausgeführt werden sollen.
partialFailure

boolean

Bei Einstellung auf „true“ werden erfolgreiche Vorgänge ausgeführt und bei ungültigen Vorgängen werden Fehler zurückgegeben. Bei „false“ werden alle Vorgänge nur dann in einer Transaktion ausgeführt, wenn sie alle gültig sind. Der Standardwert ist "false".
validateOnly

boolean

Falls wahr, wird die Anfrage validiert, aber nicht ausgeführt. Es werden nur Fehler zurückgegeben, keine Ergebnisse.
responseContentType

enum (ResponseContentType)

Die Einstellung für den Antwortinhaltstyp. Bestimmt, ob die änderbare Ressource oder nur der Ressourcenname nach der Mutation zurückgegeben werden soll. Die änderbare Ressource wird nur zurückgegeben, wenn die Ressource über das entsprechende Antwortfeld verfügt. Beispiel: MutateCampaignResult.campaign.

Antworttext

Antwortnachricht für GoogleAdsService.Mutate.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung 
{
  "partialFailureError": {
    object (Status)
  },
  "mutateOperationResponses": [
    {
      object (MutateOperationResponse)
    }
  ]
}
Felder
partialFailureError

object (Status)

Fehler, die sich auf Betriebsausfälle im Modus „Teilweise fehlgeschlagen“ beziehen. Wird nur zurückgegeben, wenn partialFailure = "true" ist und alle Fehler innerhalb der Vorgänge auftreten. Wenn Fehler außerhalb der Vorgänge auftreten (z. B. Authentifizierungsfehler), wird ein Fehler auf RPC-Ebene zurückgegeben.
mutateOperationResponses[]

object (MutateOperationResponse)

Alle Antworten für die mutate

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

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