Wyświetl listę dostępnych kont

Aby wyświetlić listę dostępnych klientów, użyj metody ListAccessibleCustomers w CustomerService. Warto jednak zrozumieć, którzy klienci są zwracani w odpowiedzi tego typu.

Wyświetlenie listy dostępnych klientów to jedno z niewielu żądań w interfejsie Search Ads 360 Reporting API, które nie wymaga podawania identyfikatora klienta i ignoruje wszystkie podane identyfikatory login-customer-id.

Powstała lista klientów jest tworzona na podstawie Twoich danych logowania OAuth. Żądanie zwróci listę wszystkich kont, na których możesz podjąć działania bezpośrednio przy obecnych danych logowania. Nie musi to obejmować wszystkich kont w hierarchii konta; będą natomiast uwzględniane tylko konta, do których dodano uwierzytelnionego użytkownika z uprawnieniami administratora lub innymi uprawnieniami na koncie.

Załóżmy, że jesteś użytkownikiem A, który jest administratorem kont M1 i C3 w 2 hierarchiach widocznych powyżej. Jeśli tworzysz wywołanie interfejsu Search Ads 360 Reporting API, na przykład do SearchAds360Service, możesz uzyskać dostęp do informacji o kontachM1 ,C1 ,C2 oraz C3. Jednak wywołanie do CustomerService.ListAccessibleCustomers zwróciłoby tylko M1 i C3, bo tylko na takich kontach użytkownik A ma bezpośredni dostęp.

Oto przykładowy kod, który ilustruje użycie metody CustomerService.ListAccessibleCustomers:

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.google.ads.searchads360.v0.lib.SearchAds360Client;
import com.google.ads.searchads360.v0.services.CustomerServiceClient;
import com.google.ads.searchads360.v0.services.ListAccessibleCustomersRequest;
import com.google.ads.searchads360.v0.services.ListAccessibleCustomersResponse;

/** List all customers that can be accessed by the authenticated Google account. */
public class ListAccessibleCustomers {

  public static void main(String[] args) {
    try {
      // Creates a SearchAds360Client with local properties file
      final SearchAds360Client searchAds360Client =
          SearchAds360Client.newBuilder().fromPropertiesFile().build();
      // Creates the Customer Service Client.
      CustomerServiceClient client = searchAds360Client.createCustomerServiceClient();
      new ListAccessibleCustomers().runExample(client);
    } catch (Exception exception) {
      System.err.printf("Failed with exception: %s%n", exception);
      exception.printStackTrace();
      System.exit(1);
    }
  }

  private void runExample(CustomerServiceClient customerServiceClient) {
    ListAccessibleCustomersResponse response =
        customerServiceClient.listAccessibleCustomers(
            ListAccessibleCustomersRequest.getDefaultInstance());

    System.out.printf("Total results: %d%n", response.getResourceNamesCount());

    for (String customerResourceName : response.getResourceNamesList()) {
      System.out.printf("Customer resource name: %s%n", customerResourceName);
    }
  }
}

Pobierz ListAccessibleCustomers.java