登录客户 ID

login-customer-id 为必填项 标头（使用经理账号访问运营客户时） 。如果直接访问运营的客户账号， login-customer-id 标头不是必需的。

获取“login-customer-id”的一种方法通过 Search Ads 360 用户 界面。“login-customer-id”当前所选客户账号的 。

经过身份验证的用户同时具有经理和运营客户的访问权限 账号，则应指定 login-customer-id，以避免产生任何歧义。 尽管在这种情况下不指定 login-customer-id 仍然有效， 仅设置为操作客户账号（可能未 预期）。

如果您一直仅使用 OAuth2 管理账号 凭据 属于某个经理账号，请按照以下步骤获取正确的 login-customer-id 值：

1. 列出可访问的客户
   

   Java

   // Copyright 2022 Google LLC
   //
   // Licensed under the Apache License, Version 2.0 (the "License");
   // you may not use this file except in compliance with the License.
   // You may obtain a copy of the License at
   //
   //     https://www.apache.org/licenses/LICENSE-2.0
   //
   // Unless required by applicable law or agreed to in writing, software
   // distributed under the License is distributed on an "AS IS" BASIS,
   // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   // See the License for the specific language governing permissions and
   // limitations under the License.
   
   package sample;
   
   import com.beust.jcommander.Parameter;
   import com.google.ads.searchads360.v0.lib.SearchAds360Client;
   import com.google.ads.searchads360.v0.resources.CustomerClient;
   import com.google.ads.searchads360.v0.services.SearchAds360Row;
   import com.google.ads.searchads360.v0.services.SearchAds360ServiceClient;
   import com.google.ads.searchads360.v0.services.SearchAds360ServiceClient.SearchPagedResponse;
   import com.google.ads.searchads360.v0.services.SearchSearchAds360Request;
   
   /** Get customer client details. */
   public class GetCustomerClient {
     private static class GetCustomerClientParams extends CodeSampleParams {
   
       @Parameter(names = "--customerId", required = true)
       private String customerId;
   
       @Parameter(names = "--loginCustomerId")
       private String loginCustomerId;
     }
   
     public static void main(String[] args) {
       GetCustomerClientParams params = new GetCustomerClientParams();
       if (!params.parseArguments(args)) {
         // Optional: You may pass the loginCustomerId on the command line or specify a loginCustomerId
         // here (10 digits, no dashes). If neither are set, customerId will be used as
         // loginCustomerId.
         // params.loginCustomerId = Long.parseLong("INSERT_LOGIN_CUSTOMER_ID_HERE");
       }
       final String loginCustomerId = params.loginCustomerId;
       final String customerId = params.customerId;
   
       try {
         // Creates a SearchAds360Client with the specified loginCustomerId. If there's
         // no loginCustomerId, customerId will be used instead.
         final SearchAds360Client searchAds360Client =
             SearchAds360Client.newBuilder()
                 .setLoginCustomerId(loginCustomerId == null ? customerId : loginCustomerId)
                 .fromPropertiesFile()
                 .build();
         // Creates the Search Ads 360 Service client.
         SearchAds360ServiceClient client = searchAds360Client.create();
         new GetCustomerClient().runExample(client, customerId);
       } catch (Exception exception) {
         System.err.printf("Failed with exception: %s%n", exception);
         exception.printStackTrace();
         System.exit(1);
       }
     }
   
     private void runExample(SearchAds360ServiceClient searchAds360ServiceClient, String customerId) {
       // Creates a query that retrieves all child accounts of the customerId specified in search
       // calls below.
       String query =
           "SELECT customer_client.descriptive_name, customer_client.client_customer,"
               + " customer_client.status FROM customer_client";
       SearchSearchAds360Request request =
           SearchSearchAds360Request.newBuilder().setCustomerId(customerId).setQuery(query).build();
   
       // Issues a search request.
       final SearchPagedResponse searchPagedResponse = searchAds360ServiceClient.search(request);
       for (SearchAds360Row element : searchPagedResponse.iterateAll()) {
         CustomerClient customerClient = element.getCustomerClient();
         System.out.printf(
             "CustomerClient found with name '%s', customer %s, and status: %s.%n",
             customerClient.getDescriptiveName(),
             customerClient.getClientCustomer(),
             customerClient.getStatus());
       }
     }
   }
   

   Download GetCustomerClient.java

   Python

   #!/usr/bin/env python
   # Copyright 2022 Google LLC
   #
   # Licensed under the Apache License, Version 2.0 (the "License");
   # you may not use this file except in compliance with the License.
   # You may obtain a copy of the License at
   #
   #     https://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS,
   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   # See the License for the specific language governing permissions and
   # limitations under the License.
   """Retrieves customer_client for a customer using a pagination search request.
   """
   
   import argparse
   import traceback
   from google.ads.searchads360.v0.services.types.search_ads360_service import SearchSearchAds360Request
   from util_searchads360 import SearchAds360Client
   
   
   def main(client, customer_id) -> None:
     search_ads_360_service = client.get_service()
   
     query = """
         SELECT
           customer_client.descriptive_name,
           customer_client.client_customer,
           customer_client.status
         FROM customer_client"""
   
     request = SearchSearchAds360Request()
     request.customer_id = customer_id
     request.query = query
   
     # Issues a search request.
     results = search_ads_360_service.search(request=request)
   
     for row in results:
       customer_client = row.customer_client
       print(
           f"CustomerClient found with name {customer_client.descriptive_name}, customer {customer_client.client_customer}, and status: {customer_client.status.name}"
       )
   
   
   if __name__ == "__main__":
     # SearchAds360Client will read the search-ads-360.yaml configuration file in
     # the home directory if none is specified.
     search_ads_360_client = SearchAds360Client.load_from_file()
   
     parser = argparse.ArgumentParser(
         description=("Retrieves customer_client for a customer."))
     # Arguments to provide to run the example.
     parser.add_argument(
         "-c",
         "--customer_id",
         type=str,
         required=True,
         help="The Search Ads 360 customer ID (10 digits, no dashes).",
     )
   
     parser.add_argument(
         "-l",
         "--login_customer_id",
         type=str,
         required=False,
         help="The Search Ads 360 login customer ID (10 digits, no dashes).",
     )
   
     args = parser.parse_args()
   
     search_ads_360_client.set_ids(args.customer_id, args.login_customer_id)
   
     try:
       main(search_ads_360_client, args.customer_id)
     except Exception:  # pylint: disable=broad-except
       traceback.print_exc()
   

   下载 get_customer_client.py

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

   Java

   // Copyright 2022 Google LLC
   //
   // Licensed under the Apache License, Version 2.0 (the "License");
   // you may not use this file except in compliance with the License.
   // You may obtain a copy of the License at
   //
   //     https://www.apache.org/licenses/LICENSE-2.0
   //
   // Unless required by applicable law or agreed to in writing, software
   // distributed under the License is distributed on an "AS IS" BASIS,
   // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   // See the License for the specific language governing permissions and
   // limitations under the License.
   
   package sample;
   
   import com.beust.jcommander.Parameter;
   import com.google.ads.searchads360.v0.lib.SearchAds360Client;
   import com.google.ads.searchads360.v0.services.SearchAds360Row;
   import com.google.ads.searchads360.v0.services.SearchAds360ServiceClient;
   import com.google.ads.searchads360.v0.services.SearchSearchAds360StreamRequest;
   import com.google.ads.searchads360.v0.services.SearchSearchAds360StreamResponse;
   import com.google.api.gax.rpc.ServerStream;
   
   /** Get manager details. */
   public class GetManagersStream {
     private static class GetManagersParams extends CodeSampleParams {
   
       @Parameter(names = "--customerId", required = true)
       private String customerId;
   
       @Parameter(names = "--loginCustomerId")
       private String loginCustomerId;
     }
   
     public static void main(String[] args) {
       GetManagersParams params = new GetManagersParams();
       if (!params.parseArguments(args)) {
         // Optional: You may pass the loginCustomerId on the command line or specify a loginCustomerId
         // here ((10 digits, no dashes). If neither are set, customerId will be used as
         // loginCustomerId.
         // params.loginCustomerId = Long.parseLong("INSERT_LOGIN_CUSTOMER_ID_HERE");
       }
       final String loginCustomerId = params.loginCustomerId;
       final String customerId = params.customerId;
   
       try {
         // Creates a SearchAds360Client with the specified loginCustomerId. If there's
         // no loginCustomerId, customerId will be used instead.
         final SearchAds360Client searchAds360Client =
             SearchAds360Client.newBuilder()
                 .setLoginCustomerId(loginCustomerId == null ? customerId : loginCustomerId)
                 .fromPropertiesFile()
                 .build();
         // Creates the Search Ads 360 Service client.
         SearchAds360ServiceClient client = searchAds360Client.create();
         new GetManagersStream().runExample(client, customerId);
       } catch (Exception exception) {
         System.err.printf("Failed with exception: %s%n", exception);
         exception.printStackTrace();
         System.exit(1);
       }
     }
   
     private void runExample(SearchAds360ServiceClient searchAds360ServiceClient, String customerId) {
       // Creates a query that retrieves manager for the customer.
       String query =
           "SELECT customer_manager_link.manager_customer, customer_manager_link.status FROM"
               + " customer_manager_link";
       SearchSearchAds360StreamRequest request =
           SearchSearchAds360StreamRequest.newBuilder()
               .setCustomerId(customerId)
               .setQuery(query)
               .build();
   
       // Issues a search stream request.
       ServerStream<SearchSearchAds360StreamResponse> stream =
           searchAds360ServiceClient.searchStreamCallable().call(request);
       for (SearchSearchAds360StreamResponse response : stream) {
         for (SearchAds360Row element : response.getResultsList()) {
           System.out.printf(
               "Manager found with customer '%s' and status: %s.%n",
               element.getCustomerManagerLink().getManagerCustomer(),
               element.getCustomerManagerLink().getStatus());
         }
       }
     }
   }
   

   Download GetManagersStream.java

   Python

   #!/usr/bin/env python
   # Copyright 2022 Google LLC
   #
   # Licensed under the Apache License, Version 2.0 (the "License");
   # you may not use this file except in compliance with the License.
   # You may obtain a copy of the License at
   #
   #     https://www.apache.org/licenses/LICENSE-2.0
   #
   # Unless required by applicable law or agreed to in writing, software
   # distributed under the License is distributed on an "AS IS" BASIS,
   # WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   # See the License for the specific language governing permissions and
   # limitations under the License.
   """Retrieves managers for a customer using a stream request."""
   
   import argparse
   import traceback
   from google.ads.searchads360.v0.services.types.search_ads360_service import SearchSearchAds360StreamRequest
   from util_searchads360 import SearchAds360Client
   
   
   def main(client, customer_id) -> None:
     search_ads_360_service = client.get_service()
   
     query = """
         SELECT
           customer_manager_link.manager_customer,
           customer_manager_link.status
         FROM customer_manager_link"""
   
     request = SearchSearchAds360StreamRequest()
     request.customer_id = customer_id
     request.query = query
   
     # Issues a search stream request.
     results = search_ads_360_service.search_stream(request=request)
   
     for response in results:
       for result in response.results:
         customer_manager_link = result.customer_manager_link
         print(
             f"Manager found with customer {customer_manager_link.manager_customer} and status: {customer_manager_link.status.name}"
         )
   
   
   if __name__ == "__main__":
     # SearchAds360Client will read the search-ads-360.yaml configuration file in
     # the home directory if none is specified.
     search_ads_360_client = SearchAds360Client.load_from_file()
   
     parser = argparse.ArgumentParser(
         description=("Retrieves managers for a customer."))
     # Arguments to provide to run the example.
     parser.add_argument(
         "-c",
         "--customer_id",
         type=str,
         required=True,
         help="The Search Ads 360 customer ID (10 digits, no dashes).",
     )
   
     parser.add_argument(
         "-l",
         "--login_customer_id",
         type=str,
         required=False,
         help="The Search Ads 360 login customer ID (10 digits, no dashes).",
     )
   
     args = parser.parse_args()
   
     search_ads_360_client.set_ids(args.customer_id, args.login_customer_id)
   
     try:
       main(search_ads_360_client, args.customer_id)
     except Exception:  # pylint: disable=broad-except
       traceback.print_exc()
   

   下载 get_managers_stream.py

3. 选择相应的经理账号。
   

   如果指定运营客户有多个经理账号 请选择层次结构顶部的经理账号。这样，您就可以 在整个生命周期中，对多次调用保持同一个 login-customer-id 账号层次结构，从而避免过度切换。