Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
İster yeni başlıyor olun, ister bir uygulamayı sürdürüyor olun, ister mevcut bir entegrasyona yeni özellikler ekliyor olun, başarılı bir Google Ads API entegrasyonu oluşturmak için test yapmak önemli bir adımdır. Bu kılavuzda, Google Ads API entegrasyonunuzu test etmeyle ilgili bazı en iyi uygulamalar açıklanmaktadır.
Test hesapları ve üretim hesapları
Geliştirme amacıyla test hesapları kullanılabilir. Test hesaplarıyla uygulama kodunuzun ve yapılandırmanızın beklendiği gibi çalıştığını doğrulayabilirsiniz.
Test hesabı sınırlamaları, entegrasyonunuzdaki bazı özellikleri test etmenizi engellediğinde bunun yerine geliştirme için bir üretim hesabı kullanabilirsiniz.
Geliştirme için kullanılan üretim hesapları, test hesaplarından şu açılardan farklıdır:
Üretim hesapları reklam yayınladığından performans raporlarını test etmenize olanak tanıyan metrikler oluşturur ve Google Ads API'nin diğer tüm özelliklerini kullanmanızı sağlar. Ancak bunları geliştirme için kullanırken ekstra dikkatli olmanız gerekir. Aşağıdaki önlemleri almanızı öneririz:
Yalnızca geliştirme amacıyla erişime ihtiyaç duyan kullanıcılara erişim izni verin.
Sabit ve düşük bir günlük hesap bütçesi belirleyin.
Geliştirme için yalnızca test hesapları kullanılamadığında üretim hesaplarını kullanın.
Bu nedenle, entegrasyonunuzu tam olarak test etmek için hem test kimlik bilgilerine hem de üretim kimlik bilgilerine ihtiyacınız olabilir.
Test amaçlı kimlik bilgileri
Geliştirme hesaplarını değiştirmeye çalışırken üretim hesaplarını yanlışlıkla değiştirme riskini en aza indirmek için üretim uygulaması kimlik bilgilerinizden ayrı bir dizi test kimlik bilgisi kullanmanızı öneririz.
Bir dizi test kimlik bilgisi oluşturmak için:
Yalnızca test amacıyla kullanılacak bir e-posta hesabı (ör. api.test@example.com) veya hizmet hesabı oluşturun.
Bu kullanıcıyı veya hizmet hesabını, testlerinizi yürüttüğünüz Google Ads hesaplarına geçerli kullanıcı olarak ekleyin. Bu kullanıcıya veya hizmet hesabına uygun erişim düzeyleri verdiğinizden emin olun. Bu kullanıcıya veya hizmet hesabına üretim hesaplarına erişim izni vermeyin.
Uygulamanızı test ederken bu yeni kimlik bilgilerini kullanın. Geliştirici jetonu, istemci kimliği ve istemci gizli anahtarı, hangi Google Ads hesaplarına erişilebileceğini belirleme konusunda herhangi bir etkisi olmadığından test amacıyla yeniden kullanılabilir.
Doğrulama isteğinde bulun
Bir isteğin geçerli olup olmadığını test etmeniz gerekiyorsa (ör. isteğin doğru şekilde yapılandırıldığını ve politikaları ihlal etmediğini doğrulamak için) GoogleAdsService.SearchStream ve GoogleAdsService.Search isteklerinin yanı sıra çoğu değiştirme isteği için kullanılabilen validate_only alanını kullanabilirsiniz.
Bu alanın belirli bir yöntem için kullanılabilir olup olmadığını doğrulamak üzere referans belgelerine bakın.
REST API
Örneğin, bir isteğin beklenen çıktıyı verdiğini doğrulamak için yapılan geçici testlerde genellikle en kolay seçenek REST API'yi kullanmaktır. REST API'ye istekte bulunurken curl'ü nasıl kullanacağınızı öğrenmek için REST örneklerine bakın. Ayrıca, REST Explorer'da test etmeyi de deneyin.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 2025-09-05 UTC."],[[["\u003cp\u003eTesting is crucial for successful Google Ads API integration, whether you're starting fresh, maintaining an app, or adding features.\u003c/p\u003e\n"],["\u003cp\u003eUtilize test accounts for development when possible, but be aware of their limitations and consider using production accounts cautiously for features not supported by test accounts.\u003c/p\u003e\n"],["\u003cp\u003eMaintain separate test credentials, especially refresh tokens, to avoid accidental modifications to production accounts.\u003c/p\u003e\n"],["\u003cp\u003eValidate your requests using the \u003ccode\u003evalidate_only\u003c/code\u003e field to ensure they are structured correctly and comply with policies.\u003c/p\u003e\n"],["\u003cp\u003eLeverage the REST API for quick, ad hoc testing and validation of request outputs.\u003c/p\u003e\n"]]],[],null,["# Testing is an important step in building a successful Google Ads API integration,\nwhether you're just getting started, maintaining an app, or adding\nnew features to an existing integration. This guide presents some best\npractices for testing your Google Ads API integration.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nTest accounts and production accounts\n-------------------------------------\n\n[Test accounts](/google-ads/api/docs/best-practices/test-accounts) are available for\ndevelopment purposes. With test accounts, you can validate that your application\ncode and configuration are working as intended.\n\nHowever, [not all\nfeatures](/google-ads/api/docs/best-practices/test-accounts#limitations) can be tested in a\ntest account account.\n\nWhen test account limitations prevent you from testing some features in your\nintegration, you can instead use a production account for development.\nProduction accounts for development differ from test accounts in the following\nways:\n\n- Serve ads that can be seen by users\n- Require valid URLs\n- Must comply with [advertising policies](//support.google.com/adspolicy/answer/6008942)\n\nBecause production accounts serve ads, they generate metrics letting you test\nperformance reports, as well as unlocking all the other features of the\nGoogle Ads API. However, using them for development requires extra caution. We\nrecommend taking the following measures:\n\n- Only grant access to users that need it for development purposes.\n- Set a fixed, low daily account budget.\n- Use production accounts for development only when test accounts can't be used.\n\nThus, to do full testing of your integration, you will likely need both test\ncredentials and production credentials.\n\nTest credentials\n----------------\n\nTo minimize the risk of accidentally modifying production accounts when trying\nto modify development accounts, we recommend maintaining a set of test\ncredentials that are separate from your production application credentials.\n\nTo create a set of test credentials:\n\n1. Create an email account (e.g. api.test@example.com) or a service account that will be used only for testing purposes.\n2. Add this user or service account as a valid user in the Google Ads accounts you are running your tests against. Make sure you give appropriate [access levels](//support.google.com/google-ads/answer/9978556) to this user or service account. Don't give this user or service account access to **any production accounts**.\n3. If you are using the [OAuth 2.0 user authentication flow, rather than the\n service account flow](/google-ads/api/docs/get-started/choose-application-type#choose-app-type), then generate a refresh token for your test user account.\n4. Use these new credentials when testing your application. The developer token, client ID, and client secret can be reused for testing purposes, since they have no effect in determining which Google Ads accounts can be accessed.\n\nRequest validation\n------------------\n\nIf you just need to test whether a request is valid---for example, to\nverify that the request is structured correctly and does not violate\npolicies---you can use the\n[`validate_only`](/google-ads/api/docs/concepts/api-structure#mutate_validation)\nfield, which is available for `GoogleAdsService.SearchStream` and\n`GoogleAdsService.Search` requests, as well as most mutate requests.\nConsult the [reference documentation](/google-ads/api/reference/rpc/v21/overview) to verify\nwhether this field is available for a given method.\n\nREST API\n--------\n\nFor ad hoc testing, for example to validate that a request yields the expected\noutput, using the REST API is often the easiest option. Consult the [REST\nexamples](/google-ads/api/rest/examples) to learn how to use curl in making\nrequests to the REST API. Also, try testing in the\n[REST explorer](/google-ads/api/rest/try-it)."]]
