קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדיקה היא שלב חשוב בפיתוח שילוב מוצלח של Google Ads API, בין אם אתם רק מתחילים, מתחזקים אפליקציה או מוסיפים תכונות חדשות לשילוב קיים. במדריך הזה מפורטות כמה שיטות מומלצות לבדיקת האינטגרציה של Google Ads API.
חשבונות בדיקה וחשבונות הפקה
חשבונות בדיקה זמינים למטרות פיתוח. באמצעות חשבונות בדיקה, אתם יכולים לוודא שהקוד וההגדרה של האפליקציה פועלים כמצופה.
אם המגבלות של חשבון הבדיקה מונעות מכם לבדוק חלק מהתכונות בשילוב, אתם יכולים להשתמש במקום זאת בחשבון פעיל לצורך פיתוח.
יש הבדלים בין חשבונות ייצור לפיתוח לבין חשבונות בדיקה, והם מפורטים בהמשך:
בחשבונות פעילים מוצגות מודעות, ולכן הם מייצרים מדדים שמאפשרים לכם לבדוק דוחות ביצועים וגם לקבל גישה לכל התכונות האחרות של Google Ads API. עם זאת, השימוש בהם לפיתוח מחייב זהירות יתרה. מומלץ לבצע את הפעולות הבאות:
חשוב להעניק גישה רק למשתמשים שזקוקים לה למטרות פיתוח.
מגדירים תקציב יומי קבוע ונמוך לחשבון.
מומלץ להשתמש בחשבונות ייצור לפיתוח רק כשאי אפשר להשתמש בחשבונות בדיקה.
לכן, כדי לבצע בדיקה מלאה של השילוב, סביר להניח שתצטרכו גם פרטי כניסה לבדיקה וגם פרטי כניסה לסביבת הייצור.
פרטי הכניסה למטרת הבדיקה
כדי לצמצם את הסיכון לשינוי לא מכוון של חשבונות בסביבת הייצור כשמנסים לשנות חשבונות בסביבת הפיתוח, מומלץ לשמור על קבוצה של פרטי כניסה לבדיקה, בנפרד מפרטי הכניסה של האפליקציה בסביבת הייצור.
כדי ליצור קבוצה של פרטי כניסה לבדיקה:
יוצרים חשבון אימייל (למשל, api.test@example.com) או חשבון שירות שישמש רק למטרות בדיקה.
מוסיפים את המשתמש או את חשבון השירות כמשתמשים תקפים בחשבונות Google Ads שבהם מריצים את הבדיקות. חשוב לוודא שנתתם רמות גישה מתאימות למשתמש או לחשבון השירות. אל תעניקו למשתמש או לחשבון השירות הזה גישה לחשבונות הפקה.
משתמשים בפרטי הכניסה החדשים כשבודקים את האפליקציה. אפשר לעשות שימוש חוזר בטוקן למפתחים, במזהה הלקוח ובסוד הלקוח למטרות בדיקה, כי אין להם השפעה על קביעת החשבונות ב-Google Ads שאפשר לגשת אליהם.
בקש אימות
אם אתם רק רוצים לבדוק אם הבקשה תקפה – למשל, כדי לוודא שהמבנה של הבקשה נכון ושהיא לא מפרה את המדיניות – אתם יכולים להשתמש בשדה validate_only, שזמין לבקשות GoogleAdsService.SearchStream ו-GoogleAdsService.Search, וגם לרוב בקשות השינוי.
כדאי לעיין במסמכי העזר כדי לבדוק אם השדה הזה זמין לשיטה מסוימת.
API ל-REST
לדוגמה, כדי לבדוק אם בקשה מסוימת מניבה את הפלט הצפוי, לרוב הכי קל להשתמש ב-REST API. כדי ללמוד איך להשתמש ב-curl כדי לשלוח בקשות ל-API ל-REST, אפשר לעיין בדוגמאות ל-REST. אפשר גם לנסות לבדוק בכלי REST Explorer.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 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)."]]
