Identyfikator klienta logowania

login-customer-id jest wymaganym w interfejsie Search Ads 360 Reporting API podczas korzystania z konta menedżera do uzyskania dostępu do klienta operacyjnego koncie. W przypadku bezpośredniego dostępu do konta klienta operacyjnego parametr Nagłówek login-customer-id nie jest wymagany.

Jednym ze sposobów uzyskania parametru „login-customer-id” zainicjował użytkownik Search Ads 360, za pomocą prostego interfejsu online. Wartość „login-customer-id” dla obecnie wybranego konta klienta to w prawym górnym rogu ekranu.

Jeśli uwierzytelniony użytkownik ma dostęp zarówno do menedżera, jak i do klienta operacyjnego kont, należy określić login-customer-id, aby uniknąć niejasności. Chociaż w tym przypadku nie określisz atrybutu login-customer-id, nadal będzie działać, jest ustawiony wyłącznie na aktywne konto klienta (co prawdopodobnie nie jest co zamierzysz).

Jeśli do zarządzania kontami korzystasz tylko z protokołu OAuth2 dane logowania konta menedżera, wykonaj te czynności, aby prawidłowo Wartość login-customer-id:

  1. Lista klientów z dostępem

    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()
    

    Pobierz plik get_customer_client.py

  2. Określanie hierarchii konta menedżera

    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()
    

    Pobierz get_managers_stream.py

  3. Wybierz odpowiednie konto menedżera.

    Jeśli istnieje kilka kont menedżera dla danego klienta operacyjnego konta, wybierz konto menedżera znajdujące się na samej górze hierarchii. Dzięki temu możesz: zachowaj tę samą wartość login-customer-id dla wielu wywołań w całym okresie hierarchii kont, aby uniknąć nadmiernej zmiany ustawień.