Sprawdź mapowania starego interfejsu Search Ads 360 API na nowy interfejs Search Ads 360 Reporting API:
Włącz interfejs Search Ads Reporting 360 API w projekcie Google Cloud.
- Otwórz bibliotekę interfejsów API w konsoli interfejsów API Google. Jeśli pojawi się taka prośba, wybierz projekt lub utwórz nowy. Biblioteka interfejsów API zawiera listę wszystkich dostępnych interfejsów API, pogrupowanych według rodziny produktów i popularności.
- Jeśli interfejs Search Ads 360 Reporting API nie jest widoczny na liście, wyszukaj go.
- Kliknij Search Ads 360 Reporting API i wybierz Włącz.
Wybierz bibliotekę klienta.
Wykonaj pierwsze połączenie.
Korzystanie z bibliotek klientów
Zalecane jest używanie biblioteki klienta Search Ads 360 Reporting API do nawiązywania połączenia z tym interfejsem.
Pobierz bibliotekę klienta Search Ads 360 Reporting API do środowiska programistycznego. Postępuj zgodnie z instrukcjami dotyczącymi danego języka, aby skonfigurować plik konfiguracji biblioteki klienta. W większości przypadków podczas przechodzenia na nową bibliotekę klienta Search Ads 360 Reporting API możesz ponownie użyć dotychczasowej konfiguracji.
Jedną z ważnych zmian jest nowy nagłówek login-customer-id. Szczegółowe informacje o tym, kiedy należy dodać ten nagłówek do konfiguracji, znajdziesz w sekcji Nagłówek Login customer ID.
Przykład konfiguracji w Javie
Z tego przykładu dowiesz się, jak zaktualizować plik searchads360.properties dla biblioteki klienta Java, zastępując w przypadku właściwości uwierzytelniania wartość doubleclicksearch wartością searchads360.
api.doubleclicksearch.clientId -> api.searchads360.clientId
api.doubleclicksearch.clientSecret -> api.searchads360.clientSecret
api.doubleclicksearch.refreshToken -> api.searchads360.refreshToken
Pierwsze połączenie
Po zaktualizowaniu pliku konfiguracji możesz wykonać pierwsze połączenie.
Pobieranie kampanii
W swoim środowisku IDE uruchom ten kod:
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.SearchAds360ServiceClient.SearchPagedResponse;
import com.google.ads.searchads360.v0.services.SearchSearchAds360Request;
/** Get campaign details. */
public class GetCampaigns {
private static final int PAGE_SIZE = 200;
private static class GetCampaignsParams extends CodeSampleParams {
@Parameter(names = "--customerId", required = true)
private String customerId;
@Parameter(names = "--loginCustomerId")
private String loginCustomerId;
}
public static void main(String[] args) {
GetCampaignsParams params = new GetCampaignsParams();
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 GetCampaigns().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 campaigns under the customerId.
String query = "SELECT campaign.name, campaign.id, campaign.status FROM campaign";
SearchSearchAds360Request request =
SearchSearchAds360Request.newBuilder()
.setCustomerId(customerId)
.setQuery(query)
.setPageSize(PAGE_SIZE)
.build();
// Issues a search request.
final SearchPagedResponse searchPagedResponse = searchAds360ServiceClient.search(request);
for (SearchAds360Row element : searchPagedResponse.iterateAll()) {
System.out.printf(
"Campaign found with name '%s', ID %d, and status: %s.%n",
element.getCampaign().getName(),
element.getCampaign().getId(),
element.getCampaign().getStatus());
}
}
}
Pobierz GetCampaigns.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 campaigns 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
_DEFAULT_PAGE_SIZE = 10000
def main(client, customer_id, page_size) -> None:
search_ads_360_service = client.get_service()
query = """
SELECT
campaign.name,
campaign.id,
campaign.status
FROM campaign"""
request = SearchSearchAds360Request()
request.customer_id = customer_id
request.query = query
request.page_size = page_size
# Issues a search request.
results = search_ads_360_service.search(request=request)
for row in results:
campaign = row.campaign
print(
f'campaign "{campaign.name}" has id {campaign.id} and status {campaign.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 campaigns 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, _DEFAULT_PAGE_SIZE)
except Exception: # pylint: disable=broad-except
traceback.print_exc()
Pobierz get_campaigns.py
Konsola powinna wydrukować listę kampanii na Twoim koncie.
Używanie interfejsu REST
Jeśli zdecydujesz się nie używać biblioteki klienta, musisz wiedzieć, jak korzystać z protokołu REST.
Jeśli używasz interfejsu REST w starej wersji Search Ads 360 API, Twoje dane logowania będą nadal działać z nowym interfejsem Search Ads 360 Reporting API. Nowy punkt końcowy i inne informacje znajdziesz w sekcji dotyczącej interfejsu REST.
Więcej informacji
Dowiedz się więcej o interfejsie Search Ads 360 Reporting API.
Zapytania:
Szkice: