Rules: list

需要授权

列出容器的所有 GTM 规则。 立即试用或查看示例。

请求

HTTP 请求

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

参数

参数名称	值	说明
路径参数
accountId	string	GTM 帐号 ID。
containerId	string	GTM 容器 ID。

授权

此请求需要获得以下至少一个范围的授权（详细了解身份验证和授权）。

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

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功，此方法将返回采用以下结构的响应正文：

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

属性名称	值	说明	备注
rules[]	list	GTM 容器的所有 GTM 规则。

示例

注意：此方法的代码示例并未列出所有受支持的编程语言（请参阅客户端库页面，查看受支持的语言列表）。

Java

使用 Java 客户端库。

/*
 * 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

使用 Python 客户端库。

# 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')

试试看！

请使用下面的 API Explorer 对实时数据调用此方法并查看响应。