Bagian berikut menjelaskan cara memulai Search Ads 360 Reporting API.
Menyiapkan project Anda di Google Cloud
Untuk menggunakan Search Ads 360 Reporting API, Anda perlu membuat project untuk aplikasi Google Cloud di Google Cloud.
Membuat project Google
Project Google berfungsi sebagai container resource untuk resource Google Cloud Anda.
- Go to the Google API Console.
- Klik Buat proyek .
- Masukkan nama atau terima saran yang dihasilkan.
- Konfirmasikan atau edit bidang yang tersisa.
- Klik Buat .
Membuat kredensial OAuth2
Search Ads 360 Reporting API menggunakan OAuth 2.0 untuk autentikasi dan otorisasi. Kredensial OAuth mengidentifikasi aplikasi Anda ke Google, dan memungkinkan Anda membuat token OAuth untuk mengelola pengguna Search Ads 360.
Untuk membuat kredensial OAuth 2.0 di Google API Console , lakukan hal berikut:
- Go to the Credentials page.
- Klik Buat kredensial> ID klien OAuth
- Pilih jenis aplikasi Anda.
- Isi formulir dan klik Buat .
Mengaktifkan Search Ads 360 Reporting API
Untuk menggunakan API tersebut, Anda harus mengaktifkan Search Ads 360 Reporting API untuk project di Konsol API Google.
Untuk mengaktifkan API untuk proyek Anda:
- Open the API Library di Google API Console .
- If prompted, select a project, or create a new one. The API Library daftar semua API yang tersedia, dikelompokkan berdasarkan keluarga produk dan popularitas.
- Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan pencarian untuk menemukannya, atau klik Lihat Semua dalam keluarga produk yang dimilikinya.
- Pilih API yang ingin Anda aktifkan, lalu klik tombol Aktifkan .
- If prompted, enable billing.
- If prompted, read and accept the API's Terms of Service.
Mengaktifkan penagihan untuk project Anda secara opsional
Penggunaan Search Ads 360 Reporting API di Google Cloud tidak dikenai biaya. Namun, ada kuota untuk jumlah total project Cloud gratis untuk setiap menggunakan akun layanan. Jika telah mencapai batas, Anda dapat mendaftar untuk yang akan menyertakan kuota proyek gratis.
Untuk mengaktifkan penagihan untuk proyek Anda:
- Kunjungi Billing page .
- Jika Anda tidak memiliki akun penagihan aktif, buat akun dengan mengklik Tambah akun penagihan dan ikuti instruksi.
Mengaktifkan layar izin project
Untuk mengaktifkan layar persetujuan proyek Anda:
- Buka Consent Screen page di Google API Console .
- If prompted, select a project, or create a new one.
- Isi formulir dan klik Simpan .
Membuat, mengedit, atau melihat URI pengalihan
Untuk membuat, melihat, atau mengedit URI redirect untuk kredensial OAuth 2.0 yang diberikan, lakukan hal berikut:
- Go to the Credentials page.
- Di bagian OAuth 2.0 klien ID halaman, klik kredensial.
- Lihat atau edit URI pengalihan.
Jika tidak ada bagian ID klien OAuth 2.0 di halaman Kredensial, maka proyek Anda tidak memiliki kredensial OAuth. Untuk membuatnya, klik Buat kredensial .
Mendownload library klien
Menggunakan library klien Search Ads 360 Reporting API adalah cara yang direkomendasikan untuk hubungkan ke Search Ads 360 Reporting API.
Download library klien Search Ads 360 Reporting API untuk pengembangan Anda lingkungan fleksibel App Engine. Ikuti petunjuk khusus bahasa di cara menyetel file konfigurasi library klien. Pada umumnya, Anda dapat menggunakan kembali konfigurasi yang sudah ada saat bermigrasi ke library klien Search Ads 360 Reporting API yang baru.
Satu perubahan penting adalah header login-customer-id
baru. Lihat
Header ID pelanggan login untuk
detail tentang kapan Anda perlu
menambahkannya ke konfigurasi Anda.
Lakukan panggilan pertama Anda
Setelah mengonfigurasi pustaka klien, Anda dapat membuat panggilan telepon.
Dapatkan Kampanye
Di IDE Anda, jalankan kode berikut:
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()); } } }Download 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()Download get_campaigns.py
Konsol akan mencetak listingan kampanye di akun Anda.
Menggunakan REST
Jika memutuskan untuk tidak menggunakan library klien, Anda perlu memahami cara menggunakan REST.
Jika Anda menggunakan REST dengan Search Ads 360 API versi sebelumnya, kredensial Anda akan tetap bekerja dengan Search Ads 360 Reporting API versi baru. Temukan endpoint baru dan detail lainnya di bagian referensi REST.
Pelajari lebih lanjut
Pelajari Search Ads 360 Reporting API lebih lanjut