Önceki Search Ads 360 Reporting API kullanımdan kaldırıldı. Artık yeni Search Ads 360 Reporting API'yi kullanarak raporlarınızı oluşturabilirsiniz.
Search Ads 360 Conversion API'deki get ve getByCustomerId yöntemlerinin desteğinin 2025'in 3. çeyreğinde sonlandırılacağını unutmayın. Dönüşüm verilerine erişmeye devam etmek için yeni Search Ads 360 Reporting API'yi kullanarak dönüşüm kaynağını kullanarak bir rapor oluşturmanız gerekir. Daha fazla ayrıntıyı burada bulabilirsiniz.
Diğer Search Ads 360 Conversion API işlevleri desteklenmeye devam edecektir.
Yetkilendirme Kurulumu
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Search Ads 360 API, kimlik doğrulaması için tüm isteklerde OAuth 2.0 erişim jetonu belirtilmesini zorunlu kılar. Jetonu oluşturmak ve Search Ads 360 API'ye iletmek için herhangi bir standart OAuth 2.0 kimlik doğrulama iş akışını uygulayabilirsiniz. Tamamen otomatik dönüşüm yüklemeleri ve rapor indirmeleri için uygun olduğu için aşağıda açıklanan iş akışını öneririz.
Aşağıda açıklanan iş akışının alternatifleri için Yüklü Uygulamalarda OAuth 2.0'ı Kullanma veya
Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma'ya göz atın. Alternatif bir iş akışı kullanıyorsanız OAuth 2.0 yetkilendirme kodu istediğinizde scope parametresi olarak aşağıdaki değeri belirtin:
https://www.googleapis.com/auth/doubleclicksearch
Sunucudan sunucuya yolu izlerseniz hizmet hesabını Search Ads 360 kullanıcısı olarak ekleyin.
Önerilen yetkilendirme iş akışı
- Google API Konsolu'na gidip projenizi seçin.
Henüz bir Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturmadıysanız İstemciniz için Google API Konsolu projesi ve OAuth kimlik bilgileri oluşturma başlıklı makaledeki talimatları uygulayın.
Projenizin OAuth istemci kimliğini ve sırrını bulmak için aşağıdakileri yapın:
- Kimlik bilgileri sayfasını açın.
- Ad sütununda OAuth istemcinizin adını tıklayın.
- İstemci kimliği ve gizli anahtar sayfada listelenir.
- Bir web tarayıcısı açın ve Search Ads 360'ta verilere erişme iznine sahip bir Google Hesabı ile Google'da oturum açın
.
Bu, API istemcinizi Search Ads 360 ile kimlik doğrulamak için kullanacağı Google Hesabı'dır.
Google Hesabı sahibi şirketinizden ayrılırsa ve Search Ads 360 erişimini hesaptan kaldırırsanız bu yetkilendirme iş akışını tekrarlamanız ve farklı bir Google Hesabı belirtmeniz gerekir.
- Search Ads 360 yardımcı programı komut dosyasını aşağıdaki gibi çağırarak yenileme jetonu alın:
sa360Api.py --login
Komut dosyası, yenileme jetonu almak için OAuth istemci kimliğini ve gizli anahtarını kullanma sürecinde size yol gösterir. Yenileme jetonu yalnızca önceki adımda oturum açtığınız Google Hesabı için geçerlidir.
Bu işlem kapsamında komut dosyası bir URL oluşturur ve URL'yi bir web tarayıcısında ziyaret etmenizi söyler.
-
Tarayıcı, OAuth istemcisinin Search Ads 360 verilerine erişmesine izin vermenizi istediğinde, daha önce oturum açtığınız Google Hesabı'nın göründüğünden emin olun. (Birden fazla Google Hesabı'nda oturum açtıysanız farklı bir hesap gösterilebilir.)
İşlemin sonunda, sa360Api.py komut dosyası virgülle ayrılmış bir dize üretir. İlk değer, sağladığınız istemci kimliği, ikinci değer sağladığınız istemci gizli anahtarı ve üçüncü değer yenileme jetonudur. Aşağıdaki örnek çıkışta, yenileme jetonu kalın metinle yazılmıştır:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw
- İstemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu arka uç veritabanında veya uygulamanızın erişebildiği başka bir güvenli konumda saklayın.
Search Ads 360 API'ye örnek JSON istekleri göndermek için sa360Api.py kullanmayı planlıyorsanız virgülle ayrılmış dizenin tamamını uygun bir konumda tutun. Komut dosyasını her çağırdığınızda dizenin tamamını parametre olarak iletirsiniz.
- Uygulamanıza aşağıdaki işlemleri yapan bir kod ekleyin:
- Yeni bir OAuth 2.0 erişim jetonu almak için istemci kimliğini, istemci gizli anahtarını ve yenileme jetonunu kullanın.
- Yeni erişim jetonunu kullanarak Search Ads 360 API'ye istek gönderin.
İstemci kitaplıklarını kullanıyorsanız bir sonraki Uygulamanızı Ayarlama bölümünde bu yetkilendirme kodunun uygulamanıza nasıl ekleneceği açıklanmaktadır.
İstemci kitaplıklarından birini kullanmıyorsanız yeni bir erişim jetonu edinmeyle ilgili öneriler için Yüklü Uygulamalar için OAuth 2.0'ı Kullanma başlıklı makaleye göz atın.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2024-11-07 UTC.
[null,null,["Son güncelleme tarihi: 2024-11-07 UTC."],[[["\u003cp\u003eThe Search Ads 360 API requires OAuth 2.0 access tokens for authentication, obtainable through standard OAuth 2.0 workflows or the recommended workflow outlined in the document.\u003c/p\u003e\n"],["\u003cp\u003eThe recommended workflow involves obtaining a refresh token using the provided utility script and storing it securely along with the client ID and secret.\u003c/p\u003e\n"],["\u003cp\u003eApplications should be designed to use the stored credentials to obtain fresh access tokens for API requests, as detailed in the "Set Up Your Application" section or relevant OAuth 2.0 documentation.\u003c/p\u003e\n"],["\u003cp\u003eAlternative workflows for installed or server-to-server applications are available with specific scope requirements and user management considerations.\u003c/p\u003e\n"]]],["The Search Ads 360 API requires OAuth 2.0 access tokens for authentication. The recommended workflow involves creating a Google API Console project and obtaining OAuth credentials. Users sign into a Google Account with Search Ads 360 access, then use the `sa360Api.py` script to generate a refresh token. The script outputs client ID, client secret, and refresh token. Store these securely, and use them in your application to obtain a fresh OAuth access token for API requests.\n"],null,["# Set Up Authorization\n\nThe Search Ads 360 API requires all requests to specify an [OAuth 2.0](/accounts/docs/OAuth2)\naccess token for authentication. You can follow any standard OAuth 2.0 authentication workflow\nto generate the token and pass it to the Search Ads 360 API. We recommend the workflow described\nbelow because it is suitable for fully automated conversion uploads and report downloads.\n\n\nFor alternatives to the workflow described below, see [Using\nOAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) or\n[Using OAuth 2.0 for Server to Server Applications](https://developers.google.com/identity/protocols/OAuth2ServiceAccount). If you use an alternate workflow,\nspecify the following value as the `scope` parameter when you request an OAuth\n2.0 authorization code: \n\n`https://www.googleapis.com/auth/doubleclicksearch`\n\nIf you follow the server to server route, add the service account as a Search Ads 360 user.\n\nRecommended authorization workflow\n----------------------------------\n\n1. Go to the [Google API Console](https://console.cloud.google.com/) and select your project.\n\n\n If you haven't already created a Google API Console project and OAuth credentials, follow\n the instructions in [Create a Google API\n Console project and OAuth credentials for your client](/search-ads/v2/prereqs#project).\n\n To find your project's OAuth client ID and secret, do the following:\n 1. Open the [Credentials page](https://console.cloud.google.com/apis/credentials).\n 2. In the **Name** column, click the name of your OAuth client.\n 3. The client ID and secret are listed on the page.\n2. Open a web browser and [sign into Google](https://accounts.google.com/ServiceLogin)with a Google Account that [has\n permission to access data](/search-ads/v2/prereqs#permissions) in Search Ads 360.\n\n This is the Google Account your API client will use to authenticate with Search Ads 360.\n If the Google Account holder leaves your company and you remove Search Ads 360 access\n from the account, you will need to repeat this authorization workflow and specify a\n different Google Account.\n3. Obtain a refresh token by invoking the [Search Ads 360 utility script](/search-ads/v2/prereqs#ds3py) as follows:\n\n\n `sa360Api.py --login`\n\n\n The script takes you through the process of using the Oauth client ID and secret to\n obtain a refresh token. The refresh token is valid only for the Google Account you signed\n into during the previous step.\n\n As part of this process, the script generates a URL and instructs you to\n visit the URL in a web browser.\n4. When the browser asks you to allow OAuth client access to Search Ads 360 data,\n make sure the Google Account you signed into earlier appears. (If you're signed into multiple\n Google Accounts, you might be presented with a different account.)\n\n\n At the end of the process, the `sa360Api.py` script outputs a comma-delimited\n string. The first value is the client ID you provided, the second value is the client\n secret you provided, and the third value is the refresh token. In the following example\n output, the refresh token is in **bold text** : \n\n `123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,`**1/HIJklM01OPQR23NOP456rst890uvw**\n5. Store the client ID, client secret, and refresh token in a backend database or other secure location that's accessible to your application.\n Keep the entire comma-delimited string in a convenient location if you plan to use\n `sa360Api.py` to send sample JSON requests to the Search Ads 360 API. You'll pass the\n entire string as a parameter each time you invoke the script.\n\n6. Add code to your application that does the following:\n 1. Use the client ID, client secret, and refresh token to obtain a fresh OAuth 2.0 access token.\n 2. Send requests to the Search Ads 360 API using the fresh access token.\n\n\n If you're using the client libraries, the next section, [Set Up Your Application](/search-ads/v2/configure),\n describes how to add this authorization code to your application.\n\n\n If you're not using one of the client libraries, see [Using OAuth 2.0 for Installed Applications](https://developers.google.com/accounts/docs/OAuth2InstalledApp) for\n suggestions on obtaining a fresh access token."]]
