Rules: list

Autorisierung erforderlich

Listet alle GTM-Regeln eines Containers auf. Probieren Sie es aus oder sehen Sie sich ein Beispiel an.

Anfragen

HTTP-Anfrage

GET https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/rules

Parameter

Parametername	Wert	Beschreibung
Pfadparameter
accountId	string	Die Google Tag Manager-Konto-ID.
containerId	string	Die GTM-Container-ID.

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

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

Anfragetext

Mit dieser Methode keinen Anfragetext bereitstellen.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "rules": [
    accounts.containers.rules Resource
  ]
}

Name der Eigenschaft	Wert	Beschreibung	Hinweise
rules[]	list	Alle GTM-Regeln eines GTM-Containers.

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 lists all rules for the authorized user.
 */
try {
  ListRulesResponse rules = tagmanager.accounts().containers().rules().
      list("123456", "54321").execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}


/*
 * The results of the list method are stored in the rules object.
 * The following code shows how to iterate through them.
 */
for (Rule rule : rules.getRules()) {
  System.out.println("Account Id = " + rule.getAccountId());
  System.out.println("Container Id = " + rule.getContainerId());
  System.out.println("Rule Id = " + rule.getRuleId());
  System.out.println("Rule Name = " + rule.getName());
  System.out.println("Rule Notes = " + rule.getNotes());

  // Get the conditions.
  if (rule.getCondition() != null) {
    for (Condition condition : rule.getCondition()) {
      System.out.println("Condition Type = " + condition.getType());
      if (condition.getParameter() != null) {
        for (Parameter parameter : condition.getParameter()) {
          System.out.println("Parameter Type = " + parameter.getType());
          System.out.println("Parameter Key = " + parameter.getKey());
          System.out.println("Parameter Value = " + parameter.getValue());
        }
      }
    }
  }
  System.out.println("Rule Fingerprint = " + rule.getFingerprint());
}

Python

Verwendet die Python-Clientbibliothek.

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

# This request lists all rules for the authorized user.
try:
  rules = tagmanager.accounts().containers().rules().list(
      accountId='123456',
      containerId='54321'
  ).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 list method are stored in the rules object.
# The following code shows how to iterate through them.
for rule in rules.get('rules', []):
  print 'Account Id = %s' % rules.get('accountId')
  print 'Container Id = %s' % rules.get('containerId')
  print 'Rule Id = %s' % rule.get('ruleId')
  print 'Rule Name = %s' % rule.get('name')
  print 'Rule Notes = %s' % rule.get('notes')
  for condition in rule.get('condition', []):
    print 'Condition Type = %s' % condition.get('type')
    for parameter in condition.get('parameter', []):
      print 'Parameter Type = %s' % parameter.get('type')
      print 'Parameter Key = %s' % parameter.get('key')
      print 'Parameter Value = %s' % parameter.get('value')
  print 'Rule Fingerprint = %s\n\n' % rule.get('fingerprint')

Jetzt testen

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