登录客户 ID

使用经理帐号访问正常操作帐号时,login-customer-id 是 Google Ads API 中新增的一个必需的标头。如果直接访问正在营业的客户帐号,则无需使用 login-customer-id 标头。

如果经过身份验证的用户同时拥有经理帐号和运营客户帐号的访问权限,则应指定 login-customer-id 以避免任何歧义。虽然指定 login-customer-id 仍可在这种情况下使用,但仅将上下文设置为操作客户帐号(这可能不符合预期)。

如果您仅使用经理帐号的 OAuth2 凭据来管理帐号,请按照以下步骤获取正确的 login-customer-id 值:

  1. 列出可访问的客户

    使用 ListAccessibleCustomers 示例,会生成一份列表,其中包含您可以使用您提供的 OAuth2 凭据访问的所有客户的列表。如此页面中所述,系统将仅返回可以直接访问的客户。经理帐号和运营中的客户帐号均可返回。

  2. 确定经理帐号层次结构

    对于第 1 步中返回的每个经理帐号,请使用 GetAccountHierarchy 示例来确定其帐号层次结构。

    请注意,如果您运行 GetAccountHierarchy 示例时未指定 login-customer-id,则它会执行第 1 步。

  3. 选择合适的经理帐号

    如果给定的操作客户帐号有多个经理帐号,请在层次结构顶部选择经理帐号。这样,您就可以在整个帐号层次结构中为多个调用维护相同的 login-customer-id,从而避免过度切换。

    此规则的例外情况是结算等情况,在这种情况下需要选择特定经理帐号