Dostępny jest już nowy interfejs Search Ads 360 Reporting API. Dołącz do grupy dyskusyjnej Google
searchads-api-announcements , aby na bieżąco otrzymywać informacje o nadchodzących ulepszeniach i wersjach.
Prześlij opinię
Pobierz grupy reklam
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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 AdGroupAds 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
ad_group_ad.ad.id,
ad_group_ad.ad.expanded_dynamic_search_ad.description1,
ad_group_ad.ad.expanded_dynamic_search_ad.description2
FROM ad_group_ad"""
request = SearchSearchAds360StreamRequest ()
request . customer_id = customer_id
request . query = query
# Issues a stream request.
results = search_ads_360_service . search_stream ( request = request )
for response in results :
for result in response . results :
ad_group_ad = result . ad_group_ad
print (
f "AdgroupAd found with id { ad_group_ad . ad . id } , description1:"
f "' { ad_group_ad . ad . expanded_dynamic_search_ad . description1 } ',"
" description2:"
f "' { ad_group_ad . ad . expanded_dynamic_search_ad . description2 } '"
)
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 AdGroupAd 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." ,
)
parser . add_argument (
"-l" ,
"--login_customer_id" ,
type = str ,
required = False ,
help = "The Search Ads 360 login customer ID." ,
)
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_ad_group_ads_stream.py
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 AdGroupAd details using SearchStream. */
public class GetAdGroupAdStream {
private static class GetAdGroupAdStreamParams extends CodeSampleParams {
@Parameter ( names = "--customerId" , required = true )
private String customerId ;
@Parameter ( names = "--loginCustomerId" )
private String loginCustomerId ;
}
public static void main ( String [] args ) {
GetAdGroupAdStreamParams params = new GetAdGroupAdStreamParams ();
if ( ! params . parseArguments ( args )) {
// Optional: You may pass the loginCustomerId on the command line or specify a loginCustomerId
// here. 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 GetAdGroupAdStream (). 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 AdGroupAd description.
String query =
"""
SELECT
ad_group_ad.ad.id, ad_group_ad.ad.expanded_dynamic_search_ad.description1,
ad_group_ad.ad.expanded_dynamic_search_ad.description2
FROM ad_group_ad
""" ;
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 (
"AdGroupAd found with id %d, description1:'%s', description2:'%s'.%n" ,
element . getAdGroupAd (). getAd (). getId (),
element . getAdGroupAd (). getAd (). getExpandedDynamicSearchAd (). getDescription1 (),
element . getAdGroupAd (). getAd (). getExpandedDynamicSearchAd (). getDescription2 ());
}
}
}
}
Pobierz GetAdGroupAdsStream.java
Prześlij opinię
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0 , a fragmenty kodu są dostępne na licencji Apache 2.0 . Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers . Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-08-29 UTC.
Chcesz przekazać coś jeszcze?
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-29 UTC."],[],["The code retrieves and displays `AdGroupAd` data from Search Ads 360. It establishes a connection to the Search Ads 360 service, defines a query to select `ad_group_ad.ad.id`, `description1`, and `description2` from `ad_group_ad`. A stream request is created and executed to fetch the data. Results are iterated over and the details, including the `id`, `description1`, and `description2` of each `AdGroupAd`, are printed. The customer and login IDs are provided via command-line arguments.\n"]]