Diese Seite wurde von der Cloud Translation API übersetzt.

Tags: update

Aktualisiert ein GTM-Tag. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/tags/tagId

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
`accountId`	`string`	Die Google Tag Manager-Konto-ID.
`containerId`	`string`	Die GTM-Container-ID.
`tagId`	`string`	Die GTM-Tag-ID.
Optionale Abfrageparameter
`fingerprint`	`string`	Wenn dieser Fingerabdruck angegeben wird, muss er mit dem Fingerabdruck des Tags im Speicher übereinstimmen.

Autorisierung

Für diese Anfrage ist eine Autorisierung in folgendem Bereich erforderlich. Weitere Informationen zur Authentifizierung und Autorisierung

Umfang
`https://www.googleapis.com/auth/tagmanager.edit.containers`

Anfragetext

Geben Sie im Anfragetext eine Tags-Ressource mit den folgenden Eigenschaften an:

Property-Name	Wert	Beschreibung	Hinweise
Erforderliche Eigenschaften
`name`	`string`	Anzeigename des Tags.	Bearbeitbar
`parameter[].type`	`string`	Der Parametertyp. Gültige Werte sind: `boolean`: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird. `integer`: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar. `list`: Es muss eine Liste mit Parametern angegeben werden `map`: Es muss eine Zuordnung von Parametern angegeben werden. `template`: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind). `trigger_reference`: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird. Zulässige Werte sind: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	Bearbeitbar
`priority.type`	`string`	Der Parametertyp. Gültige Werte sind: `boolean`: Der Wert steht für einen booleschen Wert, der als „wahr“ oder „falsch“ dargestellt wird. `integer`: Der Wert stellt einen vorzeichenbehafteten 64-Bit-Ganzzahlwert in Basis 10 dar. `list`: Es muss eine Liste mit Parametern angegeben werden `map`: Es muss eine Zuordnung von Parametern angegeben werden. `template`: Der Wert steht für beliebigen Text. Dieser kann Variablenverweise enthalten (auch Variablenverweise, die möglicherweise Typen zurückgeben, die keine Strings sind). `trigger_reference`: Der Wert stellt einen Trigger dar, der als Trigger-ID dargestellt wird. Zulässige Werte sind: "`boolean`" "`integer`" "`list`" "`map`" "`template`" "`triggerReference`"	Bearbeitbar
Optionale Attribute
`blockingRuleId[]`	`list`	Blockierregel-IDs. Wenn eine der aufgeführten Regeln als „true“ ausgewertet wird, wird das Tag nicht ausgelöst.	Bearbeitbar
`blockingTriggerId[]`	`list`	Trigger-IDs blockieren Wenn einer der aufgeführten Trigger „true“ ergibt, wird das Tag nicht ausgelöst.	Bearbeitbar
`firingRuleId[]`	`list`	Auslösungsregel-IDs Ein Tag wird ausgelöst, wenn eine der aufgeführten Regeln erfüllt ist und alle zugehörigen `blockingRuleIds`-Werte (falls vorhanden) falsch sind.	Bearbeitbar
`firingTriggerId[]`	`list`	Auslösende Trigger-IDs. Ein Tag wird ausgelöst, wenn einer der aufgelisteten Trigger wahr ist und alle seine `blockingTriggerIds` (falls vorhanden) falsch sind.	Bearbeitbar
`liveOnly`	`boolean`	Ist die Richtlinie auf „true“ gesetzt, wird dieses Tag nur in der Live-Umgebung ausgelöst, nicht im Vorschau- oder Debug-Modus.	Bearbeitbar
`notes`	`string`	Nutzerhinweise zur Anwendung dieses Tags auf den Container.	Bearbeitbar
`parameter[]`	`list`	Die Parameter des Tags.	Bearbeitbar
`parameter[].key`	`string`	Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert.	Bearbeitbar
`parameter[].list[]`	`list`	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
`parameter[].map[]`	`list`	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
`parameter[].value`	`string`	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
`paused`	`boolean`	„True“, wenn das Tag pausiert ist.	Bearbeitbar
`priority`	`nested object`	Benutzerdefinierte numerische Priorität des Tags. Tags werden asynchron in der Reihenfolge ihrer Priorität ausgelöst. Tags mit einem höheren numerischen Wert werden zuerst ausgelöst. Die Priorität eines Tags kann ein positiver oder negativer Wert sein. Der Standardwert ist 0.	Bearbeitbar
`priority.key`	`string`	Der benannte Schlüssel, der einen Parameter eindeutig identifiziert. Erforderlich für Parameter der obersten Ebene sowie für Zuordnungswerte. Wird für Listenwerte ignoriert.	Bearbeitbar
`priority.list[]`	`list`	Die Parameter dieses Listenparameters (Schlüssel werden ignoriert).	Bearbeitbar
`priority.map[]`	`list`	Die Parameter dieses Zuordnungsparameters (muss Schlüssel aufweisen; Schlüssel müssen eindeutig sein).	Bearbeitbar
`priority.value`	`string`	Der Wert eines Parameters (kann Variablenverweise wie "" enthalten) je nach Typ.	Bearbeitbar
`scheduleEndMs`	`long`	Der Endzeitstempel in Millisekunden für die Planung eines Tags.	Bearbeitbar
`scheduleStartMs`	`long`	Der Startzeitstempel in Millisekunden für die Planung eines Tags.	Bearbeitbar
`type`	`string`	GTM-Tag-Typ.	Bearbeitbar

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Tags-Ressource im Antworttext zurückgegeben.

Beispiele

Hinweis: Bei den für diese Methode verfügbaren Codebeispielen sind nicht alle unterstützten Programmiersprachen vertreten. Eine Liste der unterstützten Sprachen finden Sie auf der Seite für Clientbibliotheken.

Java

Verwendet die Java-Clientbibliothek.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing tag for the authorized user.
 */

// Construct the parameters.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("trackingId");
arg0.setValue("UA-123456-1");

Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("type");
arg1.setValue("TRACK_TRANSACTION");

// Construct the tag object.
Tag tag = new Tag();
tag.setName("Sample Universal Analytics");
tag.setType("ua");
tag.setLiveOnly(false);
tag.setParameter(Arrays.asList(arg0, arg1));

try {
  Tag response = tagmanager.accounts().
      containers().tags().update("123456", "54321", "1", tag).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Verwendet die Python-Clientbibliothek.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing new container tag.
try:
  response = tagmanager.accounts().containers().tags().update(
      accountId='123456',
      containerId='54321',
      tagId='1',
      body={
          'name': 'Universal Analytics Tag',
          'type': 'ua',
          'liveOnly': False,
          'parameter': [
              {
                  'type': 'template',
                  'key': 'trackingId',
                  'value': 'UA-123456-1'
              },
              {
                  'type': 'template',
                  'key': 'type',
                  'value': 'TRACK_TRANSACTION'
              }
          ]
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Jetzt testen

Verwenden Sie den unten angegebenen APIs Explorer, um diese Methode für Livedaten aufzurufen und die Antwort einzusehen.