İçeriğe geç
Tecrübetecrube.com
Asistan araçları · Kurulum ve kampanya

Google Ads araçları

Arama ve Performance Max kampanyaları, anahtar kelimeler, reklam metinleri, dönüşümler, teklif stratejileri ve öneriler.

Araç adları ve açıklamaları doğrudan sunucu kodundan üretilir; açıklamalar asistanın gördüğü metnin çevirisidir, araç ve parametre adları aynen kalır.

Okuma araçları45 araç

list_google_ads_accounts

Okuma1 kredi

Bağlı Google kullanıcısının erişebildiği Google Ads hesapları; MCC/yönetici hesapları altındaki müşteri hesapları dahil (id, ad, para birimi, saat dilimi, yönetici, login_customer_id) ve hangisinin seçili olduğu. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

Bu araç parametre almaz.

google_device_report

Okuma2 kredi

Cihaza göre ayrılmış Google Ads performansı (mobil, masaüstü, tablet, bağlı TV); cihaz başına CPA ve ROAS ile. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
compare_previousİsteğe bağlıboolean—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ads_recommendations

Okuma1 kredi

Google'ın kendi optimizasyon önerileri (tür, kampanya, tahmini etki). Seçilenler apply_google_ads_recommendation ile uygulanır. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
typesİsteğe bağlıarray<string>öneri türleri, ör. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
include_dismissedİsteğe bağlıboolean—
limitİsteğe bağlıinteger (1–10000)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_keyword_planner

Okuma2 kredi

Google Ads Anahtar Kelime Planlayıcı fikirleri: tohum anahtar kelimeler ya da bir URL için gerçek aylık ortalama arama, rekabet ve sayfa üstü teklif aralığı. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
seed_keywordsİsteğe bağlıarray<string>—
urlİsteğe bağlıstring—
locationİsteğe bağlıstringşehir/bölge adları, virgülle ayrılmış
countryİsteğe bağlıstringISO kodu, varsayılan TR
languageİsteğe bağlıstringtr, en, de, fr, es, ar, ru
limitİsteğe bağlıinteger (10–500)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ip_exclusions

Okuma1 kredi

Google Ads kampanyalarındaki IP hariç tutmaları. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ad_groups

Okuma1 kredi

Google Ads hesabının ya da tek bir kampanyanın reklam grupları (id, ad, durum, varsayılan CPC). Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_shared_negative_lists

Okuma1 kredi

Google Ads hesabındaki paylaşılan negatif anahtar kelime listeleri; anahtar kelime sayıları ve bağlı kampanyalarla. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
list_idİsteğe bağlıstringbu listenin anahtar kelimelerini de döndürür
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_ads

Okuma1 kredi

Duyarlı arama reklamları; her başlık/açıklama, Google'ın performans etiketi (LOW/GOOD/BEST), reklam gücü ve son URL ile. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_conversion_actions

Okuma1 kredi

Google Ads hesabının dönüşüm işlemleri: tür, kategori, durum, birincil/ikincil, sayma, değer ayarları, tıklama sonrası dönüşüm penceresi. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)also return conversions recorded per action in this window
statusİsteğe bağlıstringonly this status, e.g. ENABLED or REMOVED
searchİsteğe bağlıstringname contains
include_removedİsteğe bağlıbooleanalso list removed actions (to verify a removal)
limitİsteğe bağlıinteger (1–200)default 50
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_asset_groups

Okuma1 kredi

Performance Max varlık grupları; reklam gücü, son URL'ler ve alan türü başına metin/görsel varlıklarıyla. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
asset_group_idİsteğe bağlıstring—
signalsİsteğe bağlıbooleanalso return audience signals and search themes
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_demand_gen_campaigns

Okuma1 kredi

Google Ads hesabının Demand Gen kampanyaları; durum, teklif, günlük bütçe ve dönem performansıyla (harcama, tıklama, gösterim, dönüşüm, gelir, CTR, CPC, CPA, ROAS). Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_app_campaigns

Okuma1 kredi

Google Ads hesabının Uygulama kampanyaları; uygulama id'si, mağaza, teklif hedefi, durum, günlük bütçe ve dönem performansıyla. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_invalid_clicks_report

Okuma2 kredi

Google'ın kendi metriklerinden (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) son N gün (varsayılan 14) için kampanya ve gün bazında geçersiz tıklama (tıklama sahtekârlığı) raporu; geçersiz oranı eşiği (varsayılan %10) aşan ya da son günü sıçrayan (önceki ortalamanın 3 katı) kampanyaları işaretler, şüpheli kampanyalar için sıfır dönüşümlü yüksek tıklamalı şehirleri ekler. Dürüst sınırlar: Google yalnızca zaten filtrelediği geçersiz tıklamaları bildirir ve tıklayan IP'leri asla açıklamaz — IP düzeyinde kanıt değil, uyarı sinyalidir. Geçersiz tıklamalar ücretlendirilmez. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
threshold_rateİsteğe bağlınumberşüpheli geçersiz tıklama oranı, kesir olarak, varsayılan 0.10
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_merchant_accounts

Okuma1 kredi

Bağlı Google belirteciyle erişilebilen Google Merchant Center hesapları (Merchant API accounts v1beta): id, ad, dil, saat dilimi, test işareti. Bağlı Google iznini kullanır; Merchant Center kapsamı (auth/content) yoksa error=scope_missing döndürür — kullanıcı Google'ı yeniden yetkilendirmelidir.

Bu araç parametre almaz.

list_merchant_products

Okuma1 kredi

Merchant Center ürünleri (Merchant API products v1beta); başlık, teklif id'si, fiyat, stok durumu, hedef başına onay durumu ve ürün düzeyinde sorunlarla. Reddedilen / bekleyen / sorunlu ürünlere göre filtrelenir. Bağlı Google iznini kullanır; Merchant Center kapsamı (auth/content) yoksa error=scope_missing döndürür — kullanıcı Google'ı yeniden yetkilendirmelidir.

ParametreTipAçıklama
account_idİsteğe bağlıstringMerchant Center hesap id'si; kullanıcının tek hesabı varsa ya da biri seçiliyse isteğe bağlı
statusİsteğe bağlıall | disapproved | pending | approved | issuesissues = ürün düzeyinde herhangi bir sorun ya da reddedilmiş ülke
queryİsteğe bağlıstringbaşlık ya da teklif id'sinin bir parçası
limitİsteğe bağlıinteger (1–1000)—

get_merchant_product_issues

Okuma1 kredi

Bir Merchant Center ürününün ürün düzeyindeki sorunları (kod, önem, çözüm, açıklama, etkilenen ülkeler) ve hedef durumları; satıcının ürün verisiyle düzeltebileceği sorunları işaretler. Bağlı Google iznini kullanır; Merchant Center kapsamı (auth/content) yoksa error=scope_missing döndürür — kullanıcı Google'ı yeniden yetkilendirmelidir.

ParametreTipAçıklama
account_idİsteğe bağlıstringMerchant Center hesap id'si; kullanıcının tek hesabı varsa ya da biri seçiliyse isteğe bağlı
product_idİsteğe bağlıstringör. online~tr~TR~SKU123 (list_merchant_products sonucundan)
offer_idİsteğe bağlıstring—

merchant_feed_status

Okuma1 kredi

Merchant Center veri kaynakları (feed'ler): tür, giriş yöntemi (API/FILE/UI/AUTOFEED), feed etiketi, dil ve dosya feed'leri için son yüklemenin işleme durumu, ürün sayıları ve sorunları. Bağlı Google iznini kullanır; Merchant Center kapsamı (auth/content) yoksa error=scope_missing döndürür — kullanıcı Google'ı yeniden yetkilendirmelidir.

ParametreTipAçıklama
account_idİsteğe bağlıstringMerchant Center hesap id'si; kullanıcının tek hesabı varsa ya da biri seçiliyse isteğe bağlı

get_ad_details

Okuma1 kredi

Google Ads reklamlarının tam içeriği (tür, sabitlemeleriyle her RSA başlığı/açıklaması, URL'ler, izleme şablonu, durum), ayrıca reklam gücü, Google'ın iyileştirme önerileri ve politika onayı. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
ad_idİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_campaign_targeting

Okuma1 kredi

Bir Google Ads kampanyasının (ya da reklam grubunun) mevcut hedeflemesi: adlarıyla konumlar, hariç tutulan konumlar, yarıçap hedefleri (enlem/boylam, yarıçap, birim), diller, cihaz teklif ayarlamaları, kitleler ve varlık/ilgi konum ayarı. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_assets

Okuma2 kredi

Hesap genelindeki tüm Google Ads varlık kitaplığı (metin, boyutlarıyla görseller, YouTube videoları, site bağlantıları, açıklama metinleri, snippet'ler, aramalar, promosyonlar, fiyatlar, potansiyel müşteri formları, WhatsApp); isteğe bağlı olarak her birinin nerede kullanıldığı ve onay durumuyla. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
asset_typeİsteğe bağlıTEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED—
limitİsteğe bağlıinteger (1–1000)—
include_usageİsteğe bağlıbooleanher varlığı hangi kampanyaların/reklam gruplarının kullandığını da listeler
include_approvalİsteğe bağlıbooleanpolitika onay/inceleme durumunu ekler
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

rsa_asset_performance

Okuma2 kredi

Duyarlı arama reklamlarının başlık ve açıklama bazında sonuçları (gösterim, tıklama, maliyet, dönüşüm, değer, EBM, TO, dönüşüm oranı); Google'ın LOW/GOOD/BEST etiketi, sabitleme ve reklam gücüyle birlikte. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
daysİsteğe bağlıinteger (1–365)—
limitİsteğe bağlıinteger (1–1000)—
min_impressionsİsteğe bağlıinteger (0–…)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

keyword_historical_metrics

Okuma2 kredi

Zaten bildiğiniz anahtar kelimeler için Anahtar Kelime Planlayıcı geçmiş metrikleri: ortalama ve aylık aramalar, rekabet, sayfa üstü teklif aralığı ve ortalama CPC. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
keywordsZorunluarray<string>—
language_idİsteğe bağlıstringGoogle dil sabiti id'si, varsayılan 1037 (Türkçe)
languageİsteğe bağlıstringalternatif olarak dil kodu (tr, en…)
geo_idsİsteğe bağlıarray<string>coğrafi hedef sabiti id'leri (geo_target_search), varsayılan 2792 (Türkiye)
start_monthİsteğe bağlıstringYYYY-MM
end_monthİsteğe bağlıstringYYYY-MM
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

keyword_quality_report

Okuma2 kredi

Anahtar kelime başına üç bileşeniyle gün gün geçmiş Kalite Puanı; düştüğü tarihleri ve hangi bileşenin değiştiğini işaretler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
daysİsteğe bağlıinteger (1–90)—
limitİsteğe bağlıinteger (1–500)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_negative_keywords

Okuma1 kredi

Geçerli olan tüm negatif anahtar kelimeler: kampanya düzeyi, reklam grubu düzeyi ve kampanyalara bağlı paylaşılan negatif listeler (anahtar kelimeleriyle). Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

smart_negative_keywords

Okuma2 kredi

Negatif anahtar kelime önerileri: sıfır dönüşümle para harcamış ve hiçbir yerde zaten negatif olmayan arama terimleri, harcamaya (tahmini tasarruf) göre sıralı. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
min_wasteİsteğe bağlınumberterim başına minimum harcama
limitİsteğe bağlıinteger (1–500)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

conversion_tracking_health

Okuma2 kredi

Dönüşüm izleme check-up'ı: gizlenmiş/kaldırılmış işlemler, dönem içinde hiçbir şey kaydetmeyen birincil işlemler ve eksik birincil işlem. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

extension_asset_performance

Okuma2 kredi

Kampanya uzantılarının performansı (site bağlantıları, açıklama metinleri, arama, snippet'ler, promosyonlar, fiyatlar, WhatsApp, görseller, işletme adı/logosu): varlık başına gösterim, tıklama, maliyet, dönüşüm. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
field_typeİsteğe bağlıSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE—
limitİsteğe bağlıinteger (1–1000)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_ad_schedule

Okuma1 kredi

Bir kampanyanın mevcut reklam zamanlaması: her dilim için gün, başlangıç/bitiş saati, teklif ayarlaması ve ölçüt id'si. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

get_conversion_tags

Okuma1 kredi

Dönüşüm işlemlerinin etiket ayrıntıları: Dönüşüm Kimliği (AW-…), etiket ve Tag Manager / gtag için send_to değeri, ayrıca ham kod parçacıkları. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
conversion_action_idsİsteğe bağlıarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_extension_assets

Okuma1 kredi

Bir kampanyaya ya da reklam grubuna bağlı uzantı varlıkları (site bağlantıları, açıklama metinleri, arama, snippet'ler, promosyonlar, fiyatlar, WhatsApp, potansiyel müşteri formu, uygulama, işletme adı/logosu); kaldırmada kullanılan bağlantı kaynak adıyla. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_conversion_goals

Okuma1 kredi

Hesap dönüşüm hedefleri (kategori × kaynak) ve her birinin birincil/teklif verilebilir olup olmadığı; campaign_id ile o kampanyanın hedef geçersiz kılmaları da. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_custom_conversion_goals

Okuma1 kredi

Özel dönüşüm hedefleri: ad, içindeki dönüşüm işlemleri, durum ve her biri için optimize eden kampanyalar. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

budget_pacing_alerts

Okuma2 kredi

Etkin kampanyalarda ay başından bugüne harcamayı günlük bütçeyle karşılaştırır ve ay sonuna yansıtır; bütçeyi aşma ya da altında kalma yolundaki kampanyaları işaretler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
threshold_pctİsteğe bağlınumber (1–100)uyarıyı tetikleyen sapma, varsayılan 10
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

impression_share_analysis

Okuma2 kredi

Kampanya başına arama gösterim payı, üst / mutlak üst pay, tam eşleme payı, bütçe ve sıralama nedeniyle kaybedilen pay, ayrıca onaylanmayan reklamlar. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
levelİsteğe bağlıcampaign | ad_group—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_audiences

Okuma1 kredi

Kitle listeleri (yeniden pazarlama, kural tabanlı web sitesi, Müşteri Eşleştirme, benzer): id, tür, durum, üyelik günleri, Arama/Görüntülü boyutu ve uygunluk. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
limitİsteğe bağlıinteger (1–1000)—
definitionİsteğe bağlıbooleanlistenin kural / kaynak tanımını ekler
searchİsteğe bağlıstringname contains, or exact list id
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_experiments

Okuma1 kredi

Kampanya deneylerini (A/B testleri) id, durum ve tarihleriyle listeler. Salt okunur; birini sonlandırmak ya da uygulamak için manage_experiment. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
actionİsteğe bağlılistyalnız list; sonlandırmak ya da uygulamak için manage_experiment
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

google_campaign_diagnosis

Okuma2 kredi

Bir Google Ads kampanyasının CANLI durum tanısı. Kullanıcı bir uyarı ya da durum bildirdiğinde (yanlış yapılandırıldı, sınırlı, uygun değil, öğreniyor, reddedildi) ilk çağrılacak araçtır; bir değişiklikten sonra doğrulamak için de kullanılır. Birincil durumu ve her nedenini (kod, anlam, tipik çözüm, ilgili araçlar), yayın durumunu, teklif stratejisini ve hedef EBM / ROAS değerini, hedefin durduğu alanı, teklif stratejisinin sistem durumunu (teklif yapılandırma uyarısının asıl nedeni), uygulama kampanyası hedef türünü, bütçeyi ve Google'ın önerdiği bütçeyi, başlangıç / bitiş tarihlerini, optimize edilen dönüşüm eylemlerinin durumunu, bulguları, önerileri ve son değişiklikleri döndürür. Tutarlar hesap para birimindedir. Salt okunur. Bağlı bir Google Ads hesabı gerekir; yoksa connected=false döner, rakam uydurulmaz.

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si; verilmezse durum sorunu olan bütün kampanyalar listelenir
relatedİsteğe bağlıbooleanvarsayılan true: kampanyanın önerileri ve son 14 günün değişiklikleri de gelir
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_ad_policy_issues

Okuma2 kredi

Google'ın onaylamadığı ya da sınırladığı reklamlar; her kararın ardındaki politika konuları ve kanıt metniyle. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
only_problemsİsteğe bağlıbooleanvarsayılan true: yalnızca onaylanmayan / sınırlı reklamlar
limitİsteğe bağlıinteger (1–1000)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_lead_form_submissions

Okuma2 kredi

Google Ads potansiyel müşteri formlarıyla gönderilen kayıtlar (ad, e-posta, telefon ve özel yanıtlar, kampanya, zaman). Kişisel veri — dikkatle işleyin. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–90)—
asset_idİsteğe bağlıstringpotansiyel müşteri formu varlık id'si
limitİsteğe bağlıinteger (1–1000)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

list_google_location_assets

Okuma1 kredi

Business Profile location sync in Google Ads: location asset sets (LOCATION_SYNC, location groups), whether they are linked to the account, and the synced location assets. linked=false means ads cannot show the Business Profile address yet. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma araçları74 araç

select_google_ads_account

Yazma1 kredi

Sonraki tüm okuma ve yazmaların kullanacağı Google Ads müşteri hesabını değiştirir (ajans/MCC: doğru login-customer-id otomatik ayarlanır). Yerel ayardır; Google'da hiçbir şey değişmez.

ParametreTipAçıklama
customer_idZorunlustringlist_google_ads_accounts sonucundaki müşteri id'si

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

apply_google_ads_recommendation

Yazma2 kredi

Seçilen Google Ads önerilerini (en fazla 100) uygular. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
recommendationsZorunluarray<string>list_google_ads_recommendations sonucundaki kaynak adları
actionİsteğe bağlıapply | dismissdefault apply
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_search_campaign

Yazma2 kredi

Tek akışta Google Arama kampanyası oluşturur: bütçe, kampanya, konum + dil hedefleme, teklif stratejisi, reklam grubu, anahtar kelimeler ve duyarlı arama reklamı (metin varsayılan olarak marka profilinden). Onaydan sonra PAUSED olarak oluşturulur. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumberhesap para birimi
locationsİsteğe bağlıarray<string>şehir/bölge/ülke adları; varsayılan: marka profilindeki şehir
location_idsİsteğe bağlıarray<string>Google coğrafi hedef sabit id'leri
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>dil kodları (tr, en…) ya da Google dil id'leri; varsayılan Türkçe
bid_strategyİsteğe bağlımaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaİsteğe bağlınumber—
target_roasİsteğe bağlınumber—
max_cpcİsteğe bağlınumber—
cpc_bidİsteğe bağlınumberreklam grubu varsayılan CPC'si
keywordsİsteğe bağlıarray<any>—
headlinesİsteğe bağlıarray<any>—
descriptionsİsteğe bağlıarray<any>—
final_urlİsteğe bağlıstring—
ad_group_nameİsteğe bağlıstring—
search_partnersİsteğe bağlıboolean—
end_dateİsteğe bağlıstringYYYY-MM-DD
goalİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_pmax_campaign

Yazma2 kredi

Performance Max kampanyası oluşturur: bütçe + kampanya + varlık grubu + metin varlıkları + görseller (verilen URL'lerden indirilip yüklenir) tek atomik istekte, PAUSED olarak. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumber—
final_urlZorunlustring—
business_nameZorunlustring≤25 karakter
headlinesZorunluarray<string>3-15 adet, ≤30 karakter
long_headlinesZorunluarray<string>1-5 adet, ≤90 karakter
descriptionsZorunluarray<string>2-5 adet, ≤90 karakter
marketing_imagesZorunluarray<string>1.91:1 yatay, en az 1
square_marketing_imagesZorunluarray<string>1:1, en az 1
logo_imagesZorunluarray<string>1:1 logo, en az 1
portrait_marketing_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
landscape_logo_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
bid_strategyİsteğe bağlımaximize_conversions | maximize_conversion_value—
target_cpaİsteğe bağlınumber—
target_roasİsteğe bağlınumber—
locationsİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>—
asset_group_nameİsteğe bağlıstring—
end_dateİsteğe bağlıstring—
goalİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_display_campaign

Yazma2 kredi

Görüntülü Reklam Ağı kampanyası oluşturur: bütçe + kampanya + reklam grubu + duyarlı görüntülü reklam (görseller verilen URL'lerden indirilir, her alanın oranına kırpılıp yüklenir) tek atomik istekte, PAUSED olarak. Arama ağı kapalıdır; kampanya yalnız Görüntülü Reklam Ağı'nda yayınlanır.

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumber—
final_urlZorunlustring—
business_nameZorunlustring≤25 karakter
headlinesZorunluarray<string>1-5 adet, ≤30 karakter
long_headlineZorunlustring≤90 karakter
descriptionsZorunluarray<string>1-5 adet, ≤90 karakter
marketing_imagesZorunluarray<string>1.91:1 yatay, en az 1
square_marketing_imagesİsteğe bağlıarray<string>1:1, en az 1 (verilmezse yatay görselden kırpılır)
logo_imagesİsteğe bağlıarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesİsteğe bağlıarray<string>image URLs (https) or Studio /medya files
bid_strategyİsteğe bağlımaximize_conversions | target_cpa | maximize_clicks | manual_cpc—
target_cpaİsteğe bağlınumber—
max_cpcİsteğe bağlınumber—
cpc_bidİsteğe bağlınumber—
locationsİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>—
ad_group_nameİsteğe bağlıstring—
end_dateİsteğe bağlıstring—
goalİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_shopping_campaign

Yazma2 kredi

Standart Alışveriş kampanyası oluşturur: bütçe + kampanya + reklam grubu + ürün reklamı tek atomik istekte, PAUSED olarak. Ürünler bağlı Merchant Center hesabından gelir; 0-2 arası öncelik aynı ürüne sahip kampanyalardan hangisinin kazanacağını belirler.

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumber—
merchant_idZorunlustring—
campaign_priorityİsteğe bağlı0 | 1 | 2—
feed_labelİsteğe bağlıstring—
enable_localİsteğe bağlıboolean—
bid_strategyİsteğe bağlımanual_cpc | maximize_clicks | target_roas | maximize_conversion_value—
target_roasİsteğe bağlınumber—
max_cpcİsteğe bağlınumber—
cpc_bidİsteğe bağlınumber—
locationsİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>—
ad_group_nameİsteğe bağlıstring—
end_dateİsteğe bağlıstring—
goalİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_google_conversion_value_rules

Yazma2 kredi

Dönüşüm değerini açık artırma anında koşula göre değiştirir: ör. mobilden gelen dönüşüm 1,2 kat, belirli bir şehirden gelen daha değerli sayılır. Kural başına tek koşul (cihaz, konum ya da kitle); kural hesaba veya tek bir kampanyaya takılan bir değer kuralı kümesine bağlanır.

ParametreTipAçıklama
actionİsteğe bağlıcreate | remove—
operationİsteğe bağlıADD | MULTIPLY | SET—
valueİsteğe bağlınumberMULTIPLY için 0,5-10; ADD/SET için 0'dan büyük (hesabın para biriminde)
device_typesİsteğe bağlıarray<string>e.g. MOBILE, DESKTOP, TABLET
geo_target_idsİsteğe bağlıarray<string>—
geo_match_typeİsteğe bağlıstring—
user_list_idsİsteğe bağlıarray<string>—
campaign_idİsteğe bağlıstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
resource_nameİsteğe bağlıstringfor action=remove
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_google_campaign

Yazma2 kredi

Bir Google Ads kampanyasını yeniden adlandırır, duraklatır/etkinleştirir ya da bitiş tarihini ayarlar/kaldırır; önizlemede mevcut → yeni görünür. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
nameİsteğe bağlıstring—
statusİsteğe bağlıpause | enable—
end_dateİsteğe bağlıstring | nullYYYY-MM-DD ya da süresiz yayın için null
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

rename_google_campaigns

Yazma2 kredi

Google Ads kampanyalarını toplu yeniden adlandırır (açık liste, adlandırma kalıbı ya da bul/değiştir). Önizleme eski → yeni tablosudur; adlar benzersiz kalmalıdır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
renamesİsteğe bağlıarray<object>—
campaign_idsİsteğe bağlıarray<string>—
patternİsteğe bağlıstring{name}, {channel}, {id} içeren adlandırma kalıbı, ör. 'Brand | {channel} | {name}'
findİsteğe bağlıstring—
replaceİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

remove_google_campaign

YazmaGeri alınamaz2 kredi

Bir Google Ads kampanyasını KALICI olarak kaldırır (geri alınamaz ve yeniden etkinleştirilemez; geçmiş raporlarda kalır). Asla otomatik uygulanmaz: her zaman kullanıcının açık onayını bekler. Emin değilseniz update_google_campaign(status=pause) tercih edin. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_google_bid_strategy

Yazma2 kredi

Bir Google Ads kampanyasının teklif stratejisini değiştirir: dönüşümleri en üst düzeye çıkarma (isteğe bağlı hedef CPA), dönüşüm değerini en üst düzeye çıkarma (isteğe bağlı hedef ROAS), hedef CPA, hedef ROAS, manuel CPC, tıklamaları en üst düzeye çıkarma. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma). Uygulama kampanyasında strateji türü değiştirilemez; yalnız hedefi güncellenir (target_cpa = hedef kurulum / uygulama içi işlem maliyeti ya da target_roas). Bir uyarıyı gidermek için hedefi değiştirmeden önce google_campaign_diagnosis ile nedenini okuyun. Önceki değer saklanır ve değişiklik geri alınabilir.

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
strategyZorunlumaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share—
target_cpaİsteğe bağlınumberhesap para birimi
target_roasİsteğe bağlınumberoran, 4.0 = %400
max_cpcİsteğe bağlınumbermaximize_clicks için CPC tavanı
impression_share_locationİsteğe bağlıANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentİsteğe bağlınumber (1–100)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_google_ad_schedule

Yazma2 kredi

Bir Google Ads kampanyası için reklam planı ayarlar (gün/saat dilimleri, isteğe bağlı teklif ayarlamasıyla); dilimlerin dışında reklam yayınlanmaz. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
replaceİsteğe bağlıbooleanönce mevcut planı kaldırır
scheduleZorunluarray<object>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_google_location_targets

Yazma2 kredi

Bir Google Ads kampanyasında konum hedefler ya da hariç tutar; adlar Google'ın coğrafi hedef önerileriyle çözümlenir ve önizlemede gösterilir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
locationsİsteğe bağlıarray<string>adlar, ör. İstanbul, Ankara
location_idsİsteğe bağlıarray<string>—
countryİsteğe bağlıstringISO kodu ipucu, varsayılan TR
excludeİsteğe bağlıboolean—
replaceİsteğe bağlıbooleanönce mevcut hedeflenen konumları kaldırır
bid_adjustmentİsteğe bağlınumberyüzde
languagesİsteğe bağlıarray<string>language codes (tr, en…) or Google language ids to target
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

merge_google_campaigns

YazmaGeri alınamaz2 kredi

Güvenli kampanya birleştirme: kaynak kampanyaları duraklatır ve günlük bütçelerini hedefe taşır (Google reklam gruplarını kampanyalar arasında taşıyamaz). Bütçe korumasına tabidir (değişiklik başına en fazla +%50); asla otomatik uygulanmaz. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
target_campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
source_campaign_idsZorunluarray<string>—
move_budgetİsteğe bağlıbooleankaynakların günlük bütçelerini hedefe ekler (varsayılan true)
new_daily_budgetİsteğe bağlınumbertoplam yerine açık hedef günlük bütçe
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

exclude_google_ips

Yazma2 kredi

Bir Google Ads kampanyasından IP adreslerini hariç tutar (tıklama sahtekârlığı koruması; kampanya düzeyinde negatif IP engeli, en fazla 500). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ipsZorunluarray<string>IPv4/IPv6 adresleri ya da CIDR blokları
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

unblock_ip_addresses

Yazma2 kredi

Bir Google Ads kampanyasından IP hariç tutmalarını kaldırır (exclude_google_ips işleminin tersi); yalnızca kampanyada gerçekten hariç tutulan IP'ler kaldırılır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ipsZorunluarray<string>hariç tutulması durdurulacak IPv4/IPv6 adresleri ya da CIDR blokları
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_ad_group

Yazma2 kredi

Bir Google Ads kampanyasına, isteğe bağlı anahtar kelimeler ve duyarlı arama reklamıyla arama reklam grubu ekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
nameZorunlustring—
cpc_bidİsteğe bağlınumber—
keywordsİsteğe bağlıarray<any>—
headlinesİsteğe bağlıarray<any>—
descriptionsİsteğe bağlıarray<any>—
final_urlİsteğe bağlıstring—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_google_ad_group_status

Yazma2 kredi

Google Ads reklam gruplarını duraklatır ya da etkinleştirir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idsİsteğe bağlıarray<string>—
ad_group_idİsteğe bağlıstring—
statusZorunlupause | enable—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

pause_google_ad_groups

Yazma2 kredi

Birden çok Google Ads reklam grubunu tek seferde duraklatır (ör. google_ads_report breakdown=ad_group sonucundaki sıfır dönüşümlü gruplar). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idsZorunluarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_google_keywords

Yazma2 kredi

Bir Google Ads reklam grubuna anahtar kelimeler (metin, BROAD|PHRASE|EXACT, isteğe bağlı CPC teklifi) ekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustring—
keywordsZorunluarray<any>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_google_keyword

Yazma2 kredi

Bir Google Ads anahtar kelimesini duraklatır/etkinleştirir, CPC teklifini ya da eşleme türünü değiştirir (Google kaldır + yeniden ekle ister; tek atomik istekte yapılır). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustring—
keyword_idZorunlustring—
statusİsteğe bağlıpause | enable—
bidİsteğe bağlınumber—
match_typeİsteğe bağlıBROAD | PHRASE | EXACT—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

remove_google_negative_keywords

YazmaGeri alınamaz2 kredi

Bir Google Ads kampanyasından ya da paylaşılan negatif listesinden negatif anahtar kelimeleri kaldırır (metne, isteğe bağlı eşleme türüne göre eşleştirilir) — yanlış bir negatifin geri alınması. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
shared_list_idİsteğe bağlıstring—
keywordsİsteğe bağlıarray<string>—
criterion_idsİsteğe bağlıarray<string>negative criterion ids (list_negative_keywords) instead of / in addition to text
match_typeİsteğe bağlıBROAD | PHRASE | EXACT—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_to_google_shared_negative_list

Yazma2 kredi

Hesap genelindeki paylaşılan bir negatif listesine (her biri kendi eşleme türüyle) negatifler ekler — ya da yeni liste oluşturur — ve kampanyalara bağlar. Mevcut terimler atlanır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
list_idİsteğe bağlıstring—
list_nameİsteğe bağlıstringlist_id verilmediğinde yeni liste oluşturur
keywordsZorunluarray<any>—
attach_campaign_idsİsteğe bağlıarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_rsa

Yazma2 kredi

Bir Google Ads reklam grubunda duyarlı arama reklamı (3-15 başlık ≤30, 2-4 açıklama ≤90, isteğe bağlı sabitleme) oluşturur. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustring—
headlinesZorunluarray<any>—
descriptionsZorunluarray<any>—
final_urlZorunlustring—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
final_mobile_urlİsteğe bağlıstring—
tracking_url_templateİsteğe bağlıstring—
statusİsteğe bağlıenable | pause—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_google_rsa_assets

Yazma2 kredi

Zayıf RSA başlıklarını/açıklamalarını yeniler: Google RSA metninin düzenlenmesine izin vermediğinden yeni kümeyle yeni bir reklam oluşturulur ve eskisi tek istekte duraklatılır. Önizlemede eski → yeni metin görünür. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustring—
ad_idZorunlustring—
replace_low_performingİsteğe bağlıboolean—
remove_headlinesİsteğe bağlıarray<string>—
add_headlinesİsteğe bağlıarray<any>—
remove_descriptionsİsteğe bağlıarray<string>—
add_descriptionsİsteğe bağlıarray<any>—
headlinesİsteğe bağlıarray<any>—
descriptionsİsteğe bağlıarray<any>—
final_urlİsteğe bağlıstring—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
pause_oldİsteğe bağlıbooleanvarsayılan true
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_google_callouts

Yazma2 kredi

Bir Google Ads kampanyasına açıklama metni varlıkları (≤25 karakter) ekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
calloutsZorunluarray<string>her biri ≤25 karakter
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_conversion_action

Yazma2 kredi

Web sitesi dönüşüm işlemi oluşturur; sonuç, kurulacak etiket parçasını taşır (ör. Tag Manager araçlarıyla). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
categoryİsteğe bağlıDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeİsteğe bağlıone | many—
primary_for_goalİsteğe bağlıboolean—
default_valueİsteğe bağlınumber—
currencyİsteğe bağlıstring—
always_use_default_valueİsteğe bağlıboolean—
click_through_window_daysİsteğe bağlıinteger (1–90)—
view_through_window_daysİsteğe bağlıinteger (1–30)—
phone_call_duration_secondsİsteğe bağlıinteger (0–10800)—
typeİsteğe bağlıWEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALLdefault WEBPAGE; UPLOAD_CLICKS for offline conversion upload
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_google_conversion_action

Yazma2 kredi

Bir Google Ads dönüşüm işlemini değiştirir: birincil/ikincil (primary_for_goal), durum, kategori, sayma, değer ayarları, tıklama sonrası dönüşüm penceresi. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
conversion_action_idZorunlustring—
nameİsteğe bağlıstring—
statusİsteğe bağlıenable | hide | remove | ENABLED | HIDDEN | REMOVED—
categoryİsteğe bağlıDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
counting_typeİsteğe bağlıone | many—
primary_for_goalİsteğe bağlıboolean—
default_valueİsteğe bağlınumber—
currencyİsteğe bağlıstring—
always_use_default_valueİsteğe bağlıboolean—
click_through_window_daysİsteğe bağlıinteger (1–90)—
view_through_window_daysİsteğe bağlıinteger (1–30)—
phone_call_duration_secondsİsteğe bağlıinteger (0–10800)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_google_asset_group_assets

Yazma2 kredi

Bir Performance Max varlık grubuna tek atomik istekte başlıklar, uzun başlıklar, açıklamalar ve görseller (URL'lerden indirilip yüklenir) ekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
asset_group_idZorunlustring—
headlinesİsteğe bağlıarray<string>—
long_headlinesİsteğe bağlıarray<string>—
descriptionsİsteğe bağlıarray<string>—
business_nameİsteğe bağlıstring—
marketing_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
square_marketing_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
logo_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
portrait_marketing_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
landscape_logo_imagesİsteğe bağlıarray<string>görsel URL'leri (https) ya da Studio /medya dosyaları
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upload_google_image_asset

Yazma2 kredi

Google Ads varlık kitaplığına görsel yükler (assets:mutate, imageAsset); sonuç, create_google_demand_gen_campaign / create_google_app_campaign içinde yeniden kullanılabilen varlık kaynak adlarını döndürür. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
imagesZorunluarray<any>https URL'leri ya da Studio /medya dosyaları (JPEG/PNG/GIF, ≤5120 KB), en fazla 20
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_demand_gen_campaign

Yazma2 kredi

Google Demand Gen kampanyası (YouTube, Discover, Gmail) oluşturur: bütçe + kampanya (advertising_channel_type DEMAND_GEN) + reklam grubu + çoklu varlıklı reklam (DemandGenMultiAssetAdInfo: başlıklar, açıklamalar, işletme adı, logo, URL'lerden yüklenen ya da varlık id'siyle bağlanan yatay/kare/dikey görseller), isteğe bağlı kitle, konum ve dil hedefleme, dönüşümleri en üst düzeye çıkarma / tCPA / tROAS teklifi. Onaydan sonra PAUSED olarak oluşturulur. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumberhesap para birimi
final_urlZorunlustring—
business_nameZorunlustring≤25 karakter
headlinesZorunluarray<string>1-5 adet, ≤40 karakter
descriptionsZorunluarray<string>1-5 adet, ≤90 karakter
marketing_imagesİsteğe bağlıarray<string>1.91:1 yatay — yüklenecek URL'ler ya da mevcut varlık id'leri
square_marketing_imagesİsteğe bağlıarray<string>1:1 — URL'ler ya da varlık id'leri
portrait_marketing_imagesİsteğe bağlıarray<string>4:5 — URL'ler ya da varlık id'leri
logo_imagesZorunluarray<string>1:1 logo, en az 1 — URL'ler ya da varlık id'leri
call_to_actionİsteğe bağlıstringör. Learn more, Shop now (≤15 karakter)
bid_strategyİsteğe bağlımaximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks—
target_cpaİsteğe bağlınumber—
target_roasİsteğe bağlınumber—
max_cpcİsteğe bağlınumber—
audience_idsİsteğe bağlıarray<string>reklam grubunda hedeflenecek Google Ads Kitle id'leri (Kitle Yöneticisi); boş = geniş
locationsİsteğe bağlıarray<string>—
location_idsİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>—
ad_group_nameİsteğe bağlıstring—
end_dateİsteğe bağlıstringYYYY-MM-DD
goalİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_app_campaign

Yazma2 kredi

Google Uygulama kampanyası oluşturur (advertising_channel_type MULTI_CHANNEL, alt tür APP_CAMPAIGN, uygulama id'si, mağaza ve teklif hedefiyle app_campaign_setting): bütçe + kampanya + reklam grubu + uygulama reklamı (metin varlıkları, isteğe bağlı görsel/video), hedef CPI/CPA ya da ROAS teklifi, konum/dil hedefleme. Onaydan sonra PAUSED olarak oluşturulur; uygulama hesaba bağlı olmalıdır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
daily_budgetZorunlunumberhesap para birimi
app_idZorunlustringApple sayısal uygulama id'si (ör. 284815942) ya da Android paket adı (ör. com.example.app)
app_storeZorunluapple | google—
goalİsteğe bağlıinstalls | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registrationinstalls = yükleme başına hedef maliyet (varsayılan); in_app_actions = uygulama içinde işlem yapması olası yüklemeler (tCPI); in_app_actions_cpa = uygulama içi işlem başına hedef maliyet; value = hedef ROAS; installs_no_target / pre_registration = en üst düzeye çıkar
target_cpaİsteğe bağlınumberyükleme / uygulama içi işlem başına hedef maliyet
target_roasİsteğe bağlınumber—
conversion_action_idsİsteğe bağlıarray<string>in_app / value hedefleri için uygulama içi dönüşüm işlemleri (list_google_conversion_actions)
headlinesZorunluarray<string>2-5 adet, ≤30 karakter
descriptionsZorunluarray<string>1-5 adet, ≤90 karakter
imagesİsteğe bağlıarray<string>isteğe bağlı: yüklenecek görsel URL'leri ya da mevcut varlık id'leri
video_asset_idsİsteğe bağlıarray<string>mevcut YouTube video varlık id'leri
locationsİsteğe bağlıarray<string>—
location_idsİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
languagesİsteğe bağlıarray<string>—
ad_group_nameİsteğe bağlıstring—
end_dateİsteğe bağlıstringYYYY-MM-DD
goal_noteİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_google_app_ad

Yazma2 kredi

Google uygulama kampanyası reklamının başlık ve açıklamalarını değiştirir (mevcut metinler get_ad_details ile okunur). Sonuç önceki metinleri saklar.

ParametreTipAçıklama
ad_idZorunlustring—
headlinesİsteğe bağlıarray<string>2-5, up to 30 characters
descriptionsİsteğe bağlıarray<string>1-5, up to 90 characters
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

google_click_fraud_guard

Yazma2 kredi

Tıklama sahtekârlığı koruması: şüpheli geçersiz tıklama oranına sahip kampanyaları bulur (ya da campaign_ids alır) ve verilen IP adreslerini her birinde hariç tutar (kampanya düzeyinde negatif IP engeli). ips verilmezse yalnızca şüpheli kampanyaları ve coğrafi anormallikleri raporlar — Google Ads API tıklayan IP'leri asla açıklamaz, bu yüzden hariç tutma için kendi edindiğiniz adresler gerekir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e yalnızca onaydan sonra ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
daysİsteğe bağlıinteger (1–365)—
start_dateİsteğe bağlıstringYYYY-MM-DD
end_dateİsteğe bağlıstringYYYY-MM-DD
threshold_rateİsteğe bağlınumber—
campaign_idsİsteğe bağlıarray<string>açık kampanya listesi; varsayılan: geçersiz tıklama raporunun işaretlediği kampanyalar
ipsİsteğe bağlıarray<string>kendi sunucu/analitik günlüklerinizden IPv4/IPv6 adresleri ya da CIDR blokları
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upsert_merchant_product

Yazma2 kredi

Merchant Center ürün girdisi ekler ya da günceller (products v1beta productInputs:insert — aynı teklif id'si, dil, feed etiketi ve veri kaynağına sahip mevcut girdinin yerine geçer). Önizlemeli bir onay öğesi oluşturur; Google'a yalnızca onaydan sonra ve yalnızca bağlı Google hesabıyla gönderilir. Bağlı Google iznini kullanır; Merchant Center kapsamı (auth/content) yoksa error=scope_missing döndürür — kullanıcı Google'ı yeniden yetkilendirmelidir.

ParametreTipAçıklama
offer_idZorunlustring—
content_languageİsteğe bağlıstringvarsayılan tr
feed_labelİsteğe bağlıstringvarsayılan TR
account_idİsteğe bağlıstringMerchant Center hesap id'si; kullanıcının tek hesabı varsa ya da biri seçiliyse isteğe bağlı
data_sourceİsteğe bağlıstringveri kaynağı id'si; varsayılan: hesabın API/birincil ürün veri kaynağı
titleİsteğe bağlıstring—
descriptionİsteğe bağlıstring—
linkİsteğe bağlıstring—
image_linkİsteğe bağlıstring—
priceİsteğe bağlınumber—
sale_priceİsteğe bağlınumber—
currencyİsteğe bağlıstringISO, varsayılan TRY
availabilityİsteğe bağlıin stock | out of stock | preorder | backorder—
conditionİsteğe bağlınew | refurbished | used—
brandİsteğe bağlıstring—
gtinİsteğe bağlıstring—
googleProductCategoryİsteğe bağlıstring—
imageLinkİsteğe bağlıstringAlias of image_link
channelİsteğe bağlıONLINE | LOCALdefault ONLINE
attributesİsteğe bağlıobjectdiğer Merchant API ürün öznitelikleri (camelCase), ör. color, sizes, itemGroupId, customLabel0

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_experiment

YazmaGeri alınamaz2 kredi

Bir kampanya deneyini (A/B testi) sonlandırır ya da deneme değişikliklerini temel kampanyaya uygular. Geri alınamaz; her zaman açık onay bekler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.

ParametreTipAçıklama
experiment_idZorunlustring—
actionZorunluend | promote—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_demand_gen_ad

Yazma2 kredi

Bir Demand Gen reklam grubuna YouTube video reklamı (DemandGenVideoResponsiveAd) ekler — Demand Gen video kampanyasının yayına girmesini sağlayan kreatif. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustringGoogle Ads reklam grubu id'si (list_google_ad_groups)
youtube_videoZorunlustringYouTube URL'si ya da 11 karakterlik id ya da mevcut bir video varlığı id'si
headlinesZorunluarray<string>1-5 adet, ≤40
long_headlinesZorunluarray<string>1-5 adet, ≤90
descriptionsZorunluarray<string>1-5 adet, ≤90
business_nameZorunlustring—
final_urlZorunlustring—
logo_asset_idZorunlustring1:1 logo varlığı id'si ya da görsel URL'si
call_to_actionİsteğe bağlıLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW—
ad_nameİsteğe bağlıstring—
statusİsteğe bağlıenable | pause—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

copy_ad_group

Yazma2 kredi

Reklam gruplarını anahtar kelimeleri, negatifleri, duyarlı arama reklamları, reklam grubu varlıkları ve kitleleriyle birlikte tek atomik istekte başka bir (ya da aynı) kampanyaya çoğaltır; kopyalar varsayılan olarak duraklatılmış başlar. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idsZorunluarray<string>—
target_campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
new_nameİsteğe bağlıstring—
name_suffixİsteğe bağlıstring—
statusİsteğe bağlıpause | enablevarsayılan pause
cpc_bidİsteğe bağlınumber—
include_keywordsİsteğe bağlıboolean—
include_negativesİsteğe bağlıboolean—
include_adsİsteğe bağlıboolean—
include_assetsİsteğe bağlıboolean—
include_audiencesİsteğe bağlıboolean—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_ad_group_targeting

Yazma2 kredi

Bir reklam grubunda konum ve dil hedeflemesi (Demand Gen bunları burada tutar): hedeflenen / hariç tutulan yerleri ve dilleri ekler ya da değiştirir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustringGoogle Ads reklam grubu id'si (list_google_ad_groups)
locationsİsteğe bağlıarray<string>—
location_idsİsteğe bağlıarray<string>—
negative_locationsİsteğe bağlıarray<string>—
negative_location_idsİsteğe bağlıarray<string>—
languagesİsteğe bağlıarray<string>—
countryİsteğe bağlıstring—
modeİsteğe bağlıadd | replace—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_ad_group

Yazma2 kredi

Bir Google Ads reklam grubunu yeniden adlandırır, varsayılan maksimum TBM'sini değiştirir ve/veya duraklatır/etkinleştirir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustringGoogle Ads reklam grubu id'si (list_google_ad_groups)
nameİsteğe bağlıstring—
cpc_bidİsteğe bağlınumber—
statusİsteğe bağlıpause | enable—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_ad_status

YazmaGeri alınamaz2 kredi

Tek bir Google Ads reklamını etkinleştirir, duraklatır ya da kalıcı olarak kaldırır. REMOVED geri alınamaz ve her zaman açık onay bekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustringGoogle Ads reklam grubu id'si (list_google_ad_groups)
ad_idZorunlustring—
statusZorunluENABLED | PAUSED | REMOVED—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_pmax_assets

Yazma2 kredi

Bir Performance Max varlık grubunun metin varlıklarını tek istekte ekler ve kaldırır (görseller: add_google_asset_group_assets). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
asset_group_idZorunlustring—
headlinesİsteğe bağlıarray<string>—
long_headlinesİsteğe bağlıarray<string>—
descriptionsİsteğe bağlıarray<string>—
remove_resource_namesİsteğe bağlıarray<string>list_google_asset_groups çıktısındaki varlık grubu varlık bağlantıları
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_rsa

Yazma2 kredi

Bir duyarlı arama reklamını yerinde düzenler (aynı reklam id'si, geçmiş korunur): tüm seti değiştirir ya da tek tek başlık/açıklama ekler/kaldırır, sabitlemeleri, son URL'yi ve yolları değiştirir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_idZorunlustring—
headlinesİsteğe bağlıarray<any>—
descriptionsİsteğe bağlıarray<any>—
add_headlinesİsteğe bağlıarray<any>—
remove_headlinesİsteğe bağlıarray<string>—
add_descriptionsİsteğe bağlıarray<any>—
remove_descriptionsİsteğe bağlıarray<string>—
headline_pinsİsteğe bağlıobject{metin: sabitleme alanı} — boş dize sabitlemeyi kaldırır
description_pinsİsteğe bağlıobject{metin: sabitleme alanı} — boş dize sabitlemeyi kaldırır
final_urlİsteğe bağlıstring—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

add_negative_keyword

Yazma2 kredi

Kampanya ya da reklam grubu düzeyinde bir veya birçok negatif anahtar kelime ekler (her biri kendi eşleme türüyle); mevcut olanlar atlanır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
textİsteğe bağlıstring—
keywordsİsteğe bağlıarray<any>—
match_typeİsteğe bağlıBROAD | PHRASE | EXACT—
skip_existingİsteğe bağlıbooleanvarsayılan true
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_keywords

YazmaGeri alınamaz2 kredi

Mevcut anahtar kelimeleri toplu olarak duraklatır / etkinleştirir / kalıcı olarak kaldırır ya da maksimum TBM'lerini veya anahtar kelime düzeyindeki son URL'lerini belirler. remove açık onay bekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
ad_group_idZorunlustringGoogle Ads reklam grubu id'si (list_google_ad_groups)
criterion_idsZorunluarray<string>—
actionZorunlupause | enable | remove | set_bid | set_url—
cpc_bidİsteğe bağlınumber—
final_urlİsteğe bağlıstring—
final_mobile_urlİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_shared_negative_list

YazmaGeri alınamaz2 kredi

Hesap düzeyindeki paylaşılan negatif anahtar kelime listelerini yönetir: oluşturma, anahtar kelime ekleme/kaldırma, kampanyalara bağlama ya da ayırma, yeniden adlandırma, silme (silme açık onay bekler). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
actionZorunlucreate | add_keywords | remove_keywords | attach | detach | rename | delete—
shared_set_idİsteğe bağlıstring—
nameİsteğe bağlıstring—
keywordsİsteğe bağlıarray<any>—
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
campaign_idsİsteğe bağlıarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

dismiss_recommendations

Yazma2 kredi

İstemediğiniz Google Ads önerilerini reddeder. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
resource_namesZorunluarray<string>list_google_ads_recommendations'tan
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_extension_assets

Yazma2 kredi

Bir kampanyaya (ya da tek bir reklam grubuna) tek atomik istekte uzantı varlıkları ekler: site bağlantıları, açıklama metinleri, yapılandırılmış snippet, arama, WhatsApp mesajı, promosyonlar ve fiyat listesi. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
sitelinksİsteğe bağlıarray<object>—
calloutsİsteğe bağlıarray<string>—
snippet_headerİsteğe bağlıstringör. Services, Brands, Types, Destinations
snippet_valuesİsteğe bağlıarray<string>—
phone_numberİsteğe bağlıstring—
phone_countryİsteğe bağlıstring—
whatsapp_numberİsteğe bağlıstring—
whatsapp_countryİsteğe bağlıstring—
whatsapp_greetingİsteğe bağlıstring—
whatsapp_ctaİsteğe bağlıAPPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE—
whatsapp_cta_textİsteğe bağlıstring—
promotionsİsteğe bağlıarray<object>—
pricesİsteğe bağlıobject—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

remove_extension_assets

YazmaGeri alınamaz2 kredi

Uzantı varlıklarının bir kampanya ya da reklam grubuyla bağlantısını kaldırır (varlıklar kütüphanede kalır ve yeniden bağlanabilir). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
resource_namesİsteğe bağlıarray<string>list_extension_assets çıktısındaki bağlantı kaynak adları
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
field_typeİsteğe bağlıSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGEcampaign_id ile: bu türdeki tüm bağlantıları kaldırır
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_portfolio_bidding_strategy

Yazma2 kredi

Portföy (paylaşılan) teklif stratejileri: listeler, yeni bir tane oluşturur, hedeflerini değiştirir ya da bir kampanyayı ona bağlar. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
actionİsteğe bağlılist | create | update | assign—
nameİsteğe bağlıstring—
strategyİsteğe bağlıtarget_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share—
target_cpaİsteğe bağlınumber—
target_roasİsteğe bağlınumber—
max_cpcİsteğe bağlınumber—
min_cpcİsteğe bağlınumber—
impression_share_locationİsteğe bağlıANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentİsteğe bağlınumber (1–100)—
bidding_strategy_idİsteğe bağlıstring—
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_google_bidding_periods

Yazma2 kredi

Akıllı teklife kısa bir dönemi önceden söyler: kampanya ya da indirim için sezon düzeltmesi (beklenen dönüşüm oranı çarpanı), ya da ölçümün bozuk olduğu günler için veri hariç tutma (site kapalıydı, etiket yoktu) — o günler teklif öğrenmesine girmez. Var olanları google_ads_query ile okuyun. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
actionİsteğe bağlıcreate | remove—
typeZorunluseasonality | data_exclusion—
nameİsteğe bağlıstring—
scopeİsteğe bağlıCAMPAIGN | CHANNEL—
campaign_idsİsteğe bağlıarray<string>—
channel_typesİsteğe bağlıarray<string>—
devicesİsteğe bağlıarray<string>—
start_date_timeİsteğe bağlıstringYYYY-AA-GG ya da YYYY-AA-GG SS:DD:SS, hesabın saat diliminde
end_date_timeİsteğe bağlıstringYYYY-AA-GG ya da YYYY-AA-GG SS:DD:SS, hesabın saat diliminde
conversion_rate_modifierİsteğe bağlınumber (0.1–10)yalnız sezon düzeltmesi: 1,2 = %20 daha çok dönüşüm bekleniyor
resource_nameİsteğe bağlıstringfor action=remove
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_recommendation_auto_apply

Yazma2 kredi

Google'ın önerileri otomatik uygulama ayarını tür bazında gösterir ve değiştirir. Açmak her zaman açık onay bekler; çünkü bundan sonra Google hesabı kendi başına değiştirir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
actionİsteğe bağlılist | enable | disable—
typesİsteğe bağlıarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_conversion_goal

Yazma2 kredi

Bir dönüşüm hedefini (kategori × kaynak) hesap ya da tek bir kampanya için birincil veya ikincil yapar — Akıllı Teklif'in neyi optimize ettiğini belirler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
categoryZorunluDEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD—
originİsteğe bağlıWEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS—
roleZorunluprimary | secondary—
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_custom_conversion_goal

YazmaGeri alınamaz2 kredi

Özel bir dönüşüm hedefi oluşturur, düzenler (içindeki işlemler, ad) ya da siler; silme açık onay bekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
goal_idİsteğe bağlıstringyeni hedef oluşturmak için boş bırakın
conversion_actionsİsteğe bağlıarray<string>—
nameİsteğe bağlıstring—
removeİsteğe bağlıboolean—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upload_offline_conversions

Yazma2 kredi

Çevrimdışı (CRM) dönüşümleri tıklama id'sine (gclid/gbraid/wbraid) ya da karma hâline getirilmiş e-posta/telefona (potansiyel müşteriler için gelişmiş dönüşümler) göre yükler; e-postalar/telefonlar herhangi bir şey saklanmadan önce SHA-256 ile karma hâline getirilir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
conversion_actionZorunlustringUPLOAD_CLICKS türünde bir dönüşüm işleminin id'si
currency_codeİsteğe bağlıstring—
conversionsZorunluarray<object>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

upload_conversion_adjustments

Yazma2 kredi

Daha önce bildirilmiş dönüşümleri sipariş id'sine ya da gclid + zamana göre geri çeker (iade/iptal) veya değerini yeniden belirtir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
conversion_actionZorunlustring—
currency_codeİsteğe bağlıstring—
adjustmentsZorunluarray<object>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_customer_match_audience

Yazma2 kredi

Boş bir Müşteri Eşleştirme (Customer Match) listesi oluşturur (birinci taraf veri). Üyeler Google'ın kendi yükleme yollarıyla eklenir; bu araç asla kişisel veri yüklemez. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
membership_daysİsteğe bağlıinteger (1–540)—
upload_key_typeİsteğe bağlıCONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_google_campaign_locations

Yazma2 kredi

Show only some Business Profile locations in one campaign's ads (dynamic location group by label or listing id), so another business's address does not appear when the account syncs several businesses. Needs the account-level sync (link_google_business_profile). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
campaign_idZorunlustringTecrübe campaign id (list_campaigns) or Google Ads campaign id
label_filtersİsteğe bağlıarray<string>Business Profile labels (OR)
listing_idsİsteğe bağlıarray<string>Business Profile listing ids (OR)
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

remove_google_audience

YazmaGeri alınamaz2 kredi

Permanently remove a Google Ads audience list (Customer Match, website, lookalike). A list still used by a campaign is rejected by Google; use only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.

Bu aracın açıklaması henüz çevrilmedi; asistanın gördüğü özgün İngilizce metin gösteriliyor.

ParametreTipAçıklama
user_list_idZorunlustringaudience (user list) id from list_audiences
nameİsteğe bağlıstringlist name, shown in the approval
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_lookalike_audience

Yazma2 kredi

Belirtilen ülkeler ve erişim düzeyi için kaynak listelerden benzer kitle (Demand Gen) oluşturur. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
seed_user_list_idsZorunluarray<string>—
country_codesZorunluarray<string>—
expansion_levelİsteğe bağlıNARROW | BALANCED | BROAD—
membership_daysİsteğe bağlıinteger (1–540)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_website_audience

Yazma2 kredi

Sayfa URL'si eşleşen web sitesi ziyaretçilerinden kural tabanlı bir yeniden pazarlama listesi oluşturur (sitede Google etiketi gerekir); geçmiş ziyaretçiler önceden doldurulur. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
nameZorunlustring—
url_containsZorunluany—
string_operatorİsteğe bağlıCONTAINS | EQUALS | STARTS_WITH | ENDS_WITH—
membership_daysİsteğe bağlıinteger (1–540)—
lookback_daysİsteğe bağlıinteger (1–540)—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_audience_targeting

Yazma2 kredi

Bir kampanyaya ya da reklam grubuna kitle listesi ekler (veya kaldırır); isteğe bağlı olarak gözlem/hedefleme modunu ve teklif çarpanını ayarlar. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
audienceZorunlustringkullanıcı listesi id'si (list_audiences)
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
actionİsteğe bağlıadd | remove—
modeİsteğe bağlıobservation | targeting—
bid_modifierİsteğe bağlınumberçarpan, 1.2 = +%20
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_campaign_settings

Yazma2 kredi

Kampanya ayarlarını okur (başka bağımsız değişken yoksa) ya da değiştirir: bulunma/ilgi konum seçeneği, arama ortakları, Görüntülü Reklam Ağı genişletmesi, izleme şablonu, AB siyasi reklam beyanı, AI Max for Search. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
geo_target_typeİsteğe bağlıPRESENCE | PRESENCE_OR_INTEREST—
search_partnersİsteğe bağlıboolean—
display_expansionİsteğe bağlıboolean—
tracking_url_templateİsteğe bağlıstring—
eu_political_adsİsteğe bağlıboolean—
ai_maxİsteğe bağlıbooleanAI Max for Search
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_google_ads_account

YazmaGeri alınamaz2 kredi

Bağlı kullanıcının yönettiği bir yönetici (MCC) hesabı altında yeni bir müşteri hesabı açar. Her zaman açık onay bekler; para birimi ve saat dilimi kalıcıdır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
manager_customer_idZorunlustring—
nameZorunlustring—
currency_codeZorunlustring—
time_zoneZorunlustring—
tracking_url_templateİsteğe bağlıstring—

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

create_lead_form

Yazma2 kredi

Standart alanlar, özel sorular, teşekkür ekranı ve isteğe bağlı webhook teslimatıyla bir potansiyel müşteri formu varlığı (reklamın içindeki form) oluşturur ve bir kampanyaya ya da reklam grubuna bağlar. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (hemen yalnızca hesabın o tür için onay politikası açıkça 'kendin yap' ise) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
business_nameZorunlustring—
headlineZorunlustring—
descriptionZorunlustring—
privacy_policy_urlZorunlustring—
final_urlZorunlustring—
ctaİsteğe bağlıLEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED—
cta_descriptionİsteğe bağlıstring—
fieldsİsteğe bağlıarray<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE>—
questionsİsteğe bağlıarray<any>—
post_submit_headlineİsteğe bağlıstring—
post_submit_descriptionİsteğe bağlıstring—
post_submit_ctaİsteğe bağlıVISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW—
webhook_urlİsteğe bağlıstring—
webhook_keyİsteğe bağlıstring—
campaign_idİsteğe bağlıstringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
ad_group_idİsteğe bağlıstringGoogle Ads reklam grubu id'si (list_google_ad_groups)
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_business_name

Yazma2 kredi

Bir kampanyanın reklamlarında görünen işletme adını belirler ya da düzeltir. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
textZorunlustring≤25 karakter
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_campaign_proximity

Yazma2 kredi

Bir kampanyadaki yarıçap (enlem/boylam çemberi) hedeflerini listeler, ekler ya da kaldırır. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
actionİsteğe bağlılist | add | remove—
latİsteğe bağlınumber—
lngİsteğe bağlınumber—
radiusİsteğe bağlınumber—
unitsİsteğe bağlıKILOMETERS | MILES—
pointsİsteğe bağlıarray<object>—
criterion_idİsteğe bağlıstring—
criterion_idsİsteğe bağlıarray<string>—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

manage_device_targeting

Yazma2 kredi

Bir kampanyanın tek bir cihaz için teklif ayarlamasını belirler (ya da o cihazda gösterimi durdurmak için -%100). Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
campaign_idZorunlustringTecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si
deviceZorunluMOBILE | DESKTOP | TABLET | CONNECTED_TV—
bid_modifier_pctZorunlunumber-90..900 ya da hariç tutmak için -100
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

set_call_reporting

Yazma2 kredi

Hesap düzeyinde arama raporlamasını ve arama dönüşümü raporlamasını açar/kapatır ve arama dönüşüm işlemini seçer. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
call_reportingİsteğe bağlıboolean—
call_conversionİsteğe bağlıboolean—
call_conversion_action_idİsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.

update_pmax_asset_group

YazmaGeri alınamaz2 kredi

Bir Performance Max varlık grubunun son URL'sini, adını, görünen yollarını ya da durumunu değiştirir; REMOVED kalıcıdır ve açık onay bekler. Önizlemeli (mevcut → yeni) bir onay öğesi oluşturur; Google Ads'e kullanıcının onayından sonra (yalnızca hesabın o işlem türü için onay politikası açıkça 'kendin yap' ise hemen) ve yalnızca bağlı hesapla uygulanır (aksi halde kuru çalıştırma).

ParametreTipAçıklama
asset_group_idZorunlustring—
final_urlİsteğe bağlıstring—
nameİsteğe bağlıstring—
statusİsteğe bağlıENABLED | PAUSED | REMOVED—
path1İsteğe bağlıstring—
path2İsteğe bağlıstring—
customer_idİsteğe bağlıstringoptional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change

Yazma aracı: çağrı önce bir önizleme üretir, değişiklik yalnızca siz onayladıktan sonra platforma gider.