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 krediBağ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_ads_report
Okuma2 krediKampanya, reklam grubu, anahtar kelime, cihaz, konum, saat, haftanın günü ya da hesap (tüm MCC müşteri hesapları sıralı) bazında Google Ads performansı (harcama, tıklama, gösterim, dönüşüm, gelir, CTR, CPC, CPA, ROAS). Tarih aralığı gün sayısı ya da başlangıç/bitiş ile; compare_previous önceki dönemi ekler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
breakdownİsteğe bağlı | campaign | ad_group | ad | keyword | search_term | device | location | hour | day_of_week | account | — |
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
compare_previousİsteğe bağlı | boolean | aynı uzunluktaki önceki dönemi ve % değişimi de döndürür |
customer_idİsteğe bağlı | string | optional: 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_device_report
Okuma2 krediCihaza 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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_ads_change_history
Okuma1 krediGoogle Ads hesabında kimin neyi ne zaman değiştirdiği (en fazla son 30 gün): kullanıcı, araç (UI/API), kaynak, işlem ve eski → yeni değerler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–30) | — |
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
limitİsteğe bağlı | integer (1–1000) | — |
resource_typeİsteğe bağlı | AD | AD_GROUP | AD_GROUP_CRITERION | CAMPAIGN | CAMPAIGN_BUDGET | AD_GROUP_BID_MODIFIER | CAMPAIGN_CRITERION | AD_GROUP_AD | ASSET | CUSTOMER_ASSET | CAMPAIGN_ASSET | AD_GROUP_ASSET | ASSET_SET | ASSET_SET_ASSET | CAMPAIGN_ASSET_SET | — |
operationİsteğe bağlı | CREATE | UPDATE | REMOVE | — |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle'ı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.
| Parametre | Tip | Açıklama |
|---|---|---|
typesİsteğe bağlı | array<string> | öneri türleri, ör. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET |
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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_ads_quality_score_report
Okuma2 krediAnahtar kelime Kalite Puanı (1-10), bileşenleri (beklenen CTR, reklam alaka düzeyi, açılış sayfası deneyimi) ve harcama; düşük puanlı anahtar kelimeleri ve hangi bileşenin aşağı çektiğini özetler. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açı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ı | string | ISO kodu, varsayılan TR |
languageİsteğe bağlı | string | tr, en, de, fr, es, ar, ru |
limitİsteğe bağlı | integer (10–500) | — |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle Ads kampanyalarındaki IP hariç tutmaları. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
list_idİsteğe bağlı | string | bu listenin anahtar kelimelerini de döndürür |
customer_idİsteğe bağlı | string | optional: 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 krediDuyarlı 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | also return conversions recorded per action in this window |
statusİsteğe bağlı | string | only this status, e.g. ENABLED or REMOVED |
searchİsteğe bağlı | string | name contains |
include_removedİsteğe bağlı | boolean | also list removed actions (to verify a removal) |
limitİsteğe bağlı | integer (1–200) | default 50 |
customer_idİsteğe bağlı | string | optional: 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 krediPerformance 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrü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ı | boolean | also return audience signals and search themes |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle'ı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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-MM-DD |
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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 krediBağ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 krediMerchant 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Merchant 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 | issues | issues = ürün düzeyinde herhangi bir sorun ya da reddedilmiş ülke |
queryİsteğe bağlı | string | başlık ya da teklif id'sinin bir parçası |
limitİsteğe bağlı | integer (1–1000) | — |
get_merchant_product_issues
Okuma1 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Merchant 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 krediMerchant 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.
| Parametre | Tip | Açıklama |
|---|---|---|
account_idİsteğe bağlı | string | Merchant Center hesap id'si; kullanıcının tek hesabı varsa ya da biri seçiliyse isteğe bağlı |
google_ads_query
Okuma2 krediTek bir salt okunur Google Ads Query Language SELECT sorgusu çalıştırır ve ham satırları döndürür — özel bir aracın vermediği veriler için. Yalnızca bir SELECT kabul edilir (';', yorum ya da yazma anahtar sözcüğü yok); LIMIT zorunlu tutulur (≤1000). Para alanları mikro birimle gelir. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
queryZorunlu | string | tek bir GAQL SELECT ifadesi, ör. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS |
limitİsteğe bağlı | integer (1–1000) | — |
customer_idİsteğe bağlı | string | optional: 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_details
Okuma1 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
ad_idİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
customer_idİsteğe bağlı | string | optional: 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 krediHesap 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.
| Parametre | Tip | Açı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ı | boolean | her varlığı hangi kampanyaların/reklam gruplarının kullandığını da listeler |
include_approvalİsteğe bağlı | boolean | politika onay/inceleme durumunu ekler |
customer_idİsteğe bağlı | string | optional: 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 krediDuyarlı 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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 krediZaten 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.
| Parametre | Tip | Açıklama |
|---|---|---|
keywordsZorunlu | array<string> | — |
language_idİsteğe bağlı | string | Google dil sabiti id'si, varsayılan 1037 (Türkçe) |
languageİsteğe bağlı | string | alternatif 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ı | string | YYYY-MM |
end_monthİsteğe bağlı | string | YYYY-MM |
customer_idİsteğe bağlı | string | optional: 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 krediAnahtar 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google 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ı | string | optional: 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 krediGeç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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediNegatif 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
min_wasteİsteğe bağlı | number | terim başına minimum harcama |
limitİsteğe bağlı | integer (1–500) | — |
customer_idİsteğe bağlı | string | optional: 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 krediDö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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
customer_idİsteğe bağlı | string | optional: 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 krediKampanya 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediDö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.
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_action_idsİsteğe bağlı | array<string> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
customer_idİsteğe bağlı | string | optional: 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 krediHesap 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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.
| Parametre | Tip | Açıklama |
|---|---|---|
customer_idİsteğe bağlı | string | optional: 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 krediEtkin 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.
| Parametre | Tip | Açıklama |
|---|---|---|
threshold_pctİsteğe bağlı | number (1–100) | uyarıyı tetikleyen sapma, varsayılan 10 |
customer_idİsteğe bağlı | string | optional: 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 krediKampanya 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
levelİsteğe bağlı | campaign | ad_group | — |
customer_idİsteğe bağlı | string | optional: 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 krediKitle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
limitİsteğe bağlı | integer (1–1000) | — |
definitionİsteğe bağlı | boolean | listenin kural / kaynak tanımını ekler |
searchİsteğe bağlı | string | name contains, or exact list id |
customer_idİsteğe bağlı | string | optional: 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 krediKampanya 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.
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | list | yalnız list; sonlandırmak ya da uygulamak için manage_experiment |
customer_idİsteğe bağlı | string | optional: 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 |
geo_target_search
Okuma1 krediGoogle konum hedefleme id'lerini ada göre arar: id, tür (şehir, il, ülke…), standart ad ve erişim — id'leri konum hedeflemesinde kullanın. Bağlı bir Google Ads hesabı gerektirir; yoksa connected=false döndürür, asla uydurma rakam vermez.
| Parametre | Tip | Açıklama |
|---|---|---|
queryZorunlu | string | — |
countryİsteğe bağlı | string | ISO ülke ipucu |
levelİsteğe bağlı | string | türe göre süzer, ör. City, Province, Country, District, Postal Code |
limitİsteğe bağlı | integer (1–50) | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrü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ı | boolean | varsayılan true: kampanyanın önerileri ve son 14 günün değişiklikleri de gelir |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle'ı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.
| Parametre | Tip | Açıklama |
|---|---|---|
only_problemsİsteğe bağlı | boolean | varsayılan true: yalnızca onaylanmayan / sınırlı reklamlar |
limitİsteğe bağlı | integer (1–1000) | — |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–90) | — |
asset_idİsteğe bağlı | string | potansiyel müşteri formu varlık id'si |
limitİsteğe bağlı | integer (1–1000) | — |
customer_idİsteğe bağlı | string | optional: 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 krediBusiness 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.
| Parametre | Tip | Açıklama |
|---|---|---|
customer_idİsteğe bağlı | string | optional: 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 krediSonraki 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.
| Parametre | Tip | Açıklama |
|---|---|---|
customer_idZorunlu | string | list_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 krediSeç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).
| Parametre | Tip | Açıklama |
|---|---|---|
recommendationsZorunlu | array<string> | list_google_ads_recommendations sonucundaki kaynak adları |
actionİsteğe bağlı | apply | dismiss | default apply |
customer_idİsteğe bağlı | string | optional: 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 krediTek 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap 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ı | number | reklam 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ı | string | YYYY-MM-DD |
goalİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediPerformance 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | — |
final_urlZorunlu | string | — |
business_nameZorunlu | string | ≤25 karakter |
headlinesZorunlu | array<string> | 3-15 adet, ≤30 karakter |
long_headlinesZorunlu | array<string> | 1-5 adet, ≤90 karakter |
descriptionsZorunlu | array<string> | 2-5 adet, ≤90 karakter |
marketing_imagesZorunlu | array<string> | 1.91:1 yatay, en az 1 |
square_marketing_imagesZorunlu | array<string> | 1:1, en az 1 |
logo_imagesZorunlu | array<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ı | string | optional: 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 krediGö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.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | — |
final_urlZorunlu | string | — |
business_nameZorunlu | string | ≤25 karakter |
headlinesZorunlu | array<string> | 1-5 adet, ≤30 karakter |
long_headlineZorunlu | string | ≤90 karakter |
descriptionsZorunlu | array<string> | 1-5 adet, ≤90 karakter |
marketing_imagesZorunlu | array<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ı | string | optional: 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 krediStandart 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.
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | — |
merchant_idZorunlu | string | — |
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ı | string | optional: 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 krediDö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.
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | create | remove | — |
operationİsteğe bağlı | ADD | MULTIPLY | SET | — |
valueİsteğe bağlı | number | MULTIPLY 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ı | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
resource_nameİsteğe bağlı | string | for action=remove |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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 | null | YYYY-MM-DD ya da süresiz yayın için null |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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).
| Parametre | Tip | Açı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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
strategyZorunlu | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share | — |
target_cpaİsteğe bağlı | number | hesap para birimi |
target_roasİsteğe bağlı | number | oran, 4.0 = %400 |
max_cpcİsteğe bağlı | number | maximize_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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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 |
scheduleZorunlu | array<object> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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ı | string | ISO 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ı | number | yüzde |
languagesİsteğe bağlı | array<string> | language codes (tr, en…) or Google language ids to target |
customer_idİsteğe bağlı | string | optional: 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 krediGü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).
| Parametre | Tip | Açıklama |
|---|---|---|
target_campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
source_campaign_idsZorunlu | array<string> | — |
move_budgetİsteğe bağlı | boolean | kaynakların günlük bütçelerini hedefe ekler (varsayılan true) |
new_daily_budgetİsteğe bağlı | number | toplam yerine açık hedef günlük bütçe |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ipsZorunlu | array<string> | IPv4/IPv6 adresleri ya da CIDR blokları |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ipsZorunlu | array<string> | hariç tutulması durdurulacak IPv4/IPv6 adresleri ya da CIDR blokları |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
nameZorunlu | string | — |
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ı | string | optional: 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 krediGoogle 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idsİsteğe bağlı | array<string> | — |
ad_group_idİsteğe bağlı | string | — |
statusZorunlu | pause | enable | — |
customer_idİsteğe bağlı | string | optional: 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 krediBirden ç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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idsZorunlu | array<string> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
keywordsZorunlu | array<any> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
keyword_idZorunlu | string | — |
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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrü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ı | string | optional: 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 krediHesap 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).
| Parametre | Tip | Açıklama |
|---|---|---|
list_idİsteğe bağlı | string | — |
list_nameİsteğe bağlı | string | list_id verilmediğinde yeni liste oluşturur |
keywordsZorunlu | array<any> | — |
attach_campaign_idsİsteğe bağlı | array<string> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
headlinesZorunlu | array<any> | — |
descriptionsZorunlu | array<any> | — |
final_urlZorunlu | string | — |
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ı | string | optional: 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 krediZayı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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | — |
ad_idZorunlu | string | — |
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ı | boolean | varsayılan true |
customer_idİsteğe bağlı | string | optional: 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_sitelinks
Yazma2 krediBir Google Ads kampanyasına site bağlantısı varlıkları (metin ≤25, isteğe bağlı iki açıklama ≤35, son URL) 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
sitelinksZorunlu | array<object> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
calloutsZorunlu | array<string> | her biri ≤25 karakter |
customer_idİsteğe bağlı | string | optional: 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 krediWeb 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
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_CALL | default WEBPAGE; UPLOAD_CLICKS for offline conversion upload |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_action_idZorunlu | string | — |
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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
asset_group_idZorunlu | string | — |
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ı | string | optional: 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 krediGoogle 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).
| Parametre | Tip | Açıklama |
|---|---|---|
imagesZorunlu | array<any> | https URL'leri ya da Studio /medya dosyaları (JPEG/PNG/GIF, ≤5120 KB), en fazla 20 |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap para birimi |
final_urlZorunlu | string | — |
business_nameZorunlu | string | ≤25 karakter |
headlinesZorunlu | array<string> | 1-5 adet, ≤40 karakter |
descriptionsZorunlu | array<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_imagesZorunlu | array<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ı | string | YYYY-MM-DD |
goalİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
daily_budgetZorunlu | number | hesap para birimi |
app_idZorunlu | string | Apple sayısal uygulama id'si (ör. 284815942) ya da Android paket adı (ör. com.example.app) |
app_storeZorunlu | apple | google | — |
goalİsteğe bağlı | installs | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registration | installs = 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ı | number | yü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) |
headlinesZorunlu | array<string> | 2-5 adet, ≤30 karakter |
descriptionsZorunlu | array<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ı | string | YYYY-MM-DD |
goal_noteİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle 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.
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
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ı | string | optional: 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 krediTı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).
| Parametre | Tip | Açıklama |
|---|---|---|
daysİsteğe bağlı | integer (1–365) | — |
start_dateİsteğe bağlı | string | YYYY-MM-DD |
end_dateİsteğe bağlı | string | YYYY-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ı | string | optional: 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 krediMerchant 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.
| Parametre | Tip | Açıklama |
|---|---|---|
offer_idZorunlu | string | — |
content_languageİsteğe bağlı | string | varsayılan tr |
feed_labelİsteğe bağlı | string | varsayılan TR |
account_idİsteğe bağlı | string | Merchant 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ı | string | veri 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ı | string | ISO, 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ı | string | Alias of image_link |
channelİsteğe bağlı | ONLINE | LOCAL | default ONLINE |
attributesİsteğe bağlı | object | diğ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 krediBir 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.
| Parametre | Tip | Açıklama |
|---|---|---|
experiment_idZorunlu | string | — |
actionZorunlu | end | promote | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
youtube_videoZorunlu | string | YouTube URL'si ya da 11 karakterlik id ya da mevcut bir video varlığı id'si |
headlinesZorunlu | array<string> | 1-5 adet, ≤40 |
long_headlinesZorunlu | array<string> | 1-5 adet, ≤90 |
descriptionsZorunlu | array<string> | 1-5 adet, ≤90 |
business_nameZorunlu | string | — |
final_urlZorunlu | string | — |
logo_asset_idZorunlu | string | 1: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ı | string | optional: 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 krediReklam 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idsZorunlu | array<string> | — |
target_campaign_idZorunlu | string | Tecrü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 | enable | varsayı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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | Google 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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | Google 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ı | string | optional: 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 krediTek 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
ad_idZorunlu | string | — |
statusZorunlu | ENABLED | PAUSED | REMOVED | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
asset_group_idZorunlu | string | — |
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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_idZorunlu | string | — |
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ı | string | optional: 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 krediKampanya 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google 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ı | boolean | varsayılan true |
customer_idİsteğe bağlı | string | optional: 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 krediMevcut 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).
| Parametre | Tip | Açıklama |
|---|---|---|
ad_group_idZorunlu | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
criterion_idsZorunlu | array<string> | — |
actionZorunlu | pause | 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ı | string | optional: 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 krediHesap 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).
| Parametre | Tip | Açıklama |
|---|---|---|
actionZorunlu | create | 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ı | string | Tecrü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ı | string | optional: 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).
| Parametre | Tip | Açıklama |
|---|---|---|
resource_namesZorunlu | array<string> | list_google_ads_recommendations'tan |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google 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ı | string | optional: 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 krediUzantı 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).
| Parametre | Tip | Açı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ı | string | Tecrü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 | campaign_id ile: bu türdeki tüm bağlantıları kaldırır |
customer_idİsteğe bağlı | string | optional: 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_sitelink
Yazma2 krediMevcut bir site bağlantısını yeniden oluşturmadan yerinde düzenler (bağlantı metni, iki açıklama satırı, son URL). Ö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).
| Parametre | Tip | Açıklama |
|---|---|---|
asset_idZorunlu | string | — |
link_textİsteğe bağlı | string | — |
description1İsteğe bağlı | string | — |
description2İsteğe bağlı | string | — |
final_urlİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediPortfö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).
| Parametre | Tip | Açı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ı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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 krediAkı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).
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | create | remove | — |
typeZorunlu | seasonality | 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ı | string | YYYY-AA-GG ya da YYYY-AA-GG SS:DD:SS, hesabın saat diliminde |
end_date_timeİsteğe bağlı | string | YYYY-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ı | string | for action=remove |
customer_idİsteğe bağlı | string | optional: 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 krediGoogle'ı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).
| Parametre | Tip | Açıklama |
|---|---|---|
actionİsteğe bağlı | list | enable | disable | — |
typesİsteğe bağlı | array<string> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
categoryZorunlu | 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 | — |
originİsteğe bağlı | WEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS | — |
roleZorunlu | primary | secondary | — |
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
customer_idİsteğe bağlı | string | optional: 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).
| Parametre | Tip | Açıklama |
|---|---|---|
goal_idİsteğe bağlı | string | yeni 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ı | string | optional: 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).
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_actionZorunlu | string | UPLOAD_CLICKS türünde bir dönüşüm işleminin id'si |
currency_codeİsteğe bağlı | string | — |
conversionsZorunlu | array<object> | — |
customer_idİsteğe bağlı | string | optional: 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 krediDaha ö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).
| Parametre | Tip | Açıklama |
|---|---|---|
conversion_actionZorunlu | string | — |
currency_codeİsteğe bağlı | string | — |
adjustmentsZorunlu | array<object> | — |
customer_idİsteğe bağlı | string | optional: 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 krediBoş 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
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ı | string | optional: 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.
link_google_business_profile
Yazma2 krediLink Google Business Profile locations to the Google Ads account as location assets (address, directions, call in ads; store visit conversions). Uses the connected Business Profile; filter by business name, label or listing id when the profile has several businesses. Only one sync per account; an existing one is reused. 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.
| Parametre | Tip | Açıklama |
|---|---|---|
business_name_filterİsteğe bağlı | string | only listings with this business name |
label_filtersİsteğe bağlı | array<string> | only listings with one of these Business Profile labels |
listing_idsİsteğe bağlı | array<string> | only these Business Profile listing ids |
business_account_idİsteğe bağlı | string | — |
emailİsteğe bağlı | string | Business Profile account e-mail; default: the connected Google account |
nameİsteğe bağlı | string | — |
customer_idİsteğe bağlı | string | optional: 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 krediShow 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.
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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ı | string | optional: 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 krediPermanently 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.
| Parametre | Tip | Açıklama |
|---|---|---|
user_list_idZorunlu | string | audience (user list) id from list_audiences |
nameİsteğe bağlı | string | list name, shown in the approval |
customer_idİsteğe bağlı | string | optional: 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 krediBelirtilen ü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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
seed_user_list_idsZorunlu | array<string> | — |
country_codesZorunlu | array<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ı | string | optional: 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 krediSayfa 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).
| Parametre | Tip | Açıklama |
|---|---|---|
nameZorunlu | string | — |
url_containsZorunlu | any | — |
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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
audienceZorunlu | string | kullanıcı listesi id'si (list_audiences) |
campaign_idİsteğe bağlı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google 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ı | string | optional: 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 krediKampanya 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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ı | boolean | AI Max for Search |
customer_idİsteğe bağlı | string | optional: 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 krediBağ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).
| Parametre | Tip | Açıklama |
|---|---|---|
manager_customer_idZorunlu | string | — |
nameZorunlu | string | — |
currency_codeZorunlu | string | — |
time_zoneZorunlu | string | — |
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 krediStandart 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).
| Parametre | Tip | Açıklama |
|---|---|---|
business_nameZorunlu | string | — |
headlineZorunlu | string | — |
descriptionZorunlu | string | — |
privacy_policy_urlZorunlu | string | — |
final_urlZorunlu | string | — |
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ı | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
ad_group_idİsteğe bağlı | string | Google Ads reklam grubu id'si (list_google_ad_groups) |
customer_idİsteğe bağlı | string | optional: 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_logo
Yazma2 krediBir kampanyanın reklamlarında görünen işletme logosunu 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
asset_idZorunlu | string | 1:1 görsel varlık id'si ya da görsel URL'si |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
textZorunlu | string | ≤25 karakter |
customer_idİsteğe bağlı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrü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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
campaign_idZorunlu | string | Tecrübe kampanya id'si (list_campaigns) ya da Google Ads kampanya id'si |
deviceZorunlu | MOBILE | DESKTOP | TABLET | CONNECTED_TV | — |
bid_modifier_pctZorunlu | number | -90..900 ya da hariç tutmak için -100 |
customer_idİsteğe bağlı | string | optional: 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 krediHesap 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).
| Parametre | Tip | Açı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ı | string | optional: 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 krediBir 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).
| Parametre | Tip | Açıklama |
|---|---|---|
asset_group_idZorunlu | string | — |
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ı | string | optional: 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.