קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קוד המפתח הוא מחרוזת אלפאנומרית באורך 22 תווים שמאפשרת לאפליקציה שלכם להתחבר ל-Google Ads API. אחרי ש-Google מקצה לכם את קוד המפתח, אתם יכולים לראות אותו או ליצור קוד מפתח חדש בדף מרכז ה-API בחשבון הניהול שלכם ב-Google Ads.
לכל קוד מפתח מוקצית רמת גישה שקובעת את מספר הקריאות ל-API שאפשר לבצע ביום באמצעות קוד המפתח, וגם את הסביבה שאליה אפשר לבצע קריאות.
כדי לבצע קריאות ל-API בחשבון הפעיל, צריך לבקש רמת גישה של גישה בסיסית או גישה רגילה לקוד המפתח במהלך תהליך הבקשה לקבלת קוד המפתח. מכיוון שרמות הגישה האלה לא נדרשות כדי לבצע קריאות לחשבונות בדיקה, אפשר להמשיך בתרגילים, אבל מומלץ לעיין במאמר איך מבקשים רמת גישה בסיסית אחרי שתסיימו את המדריך הזה.
צריך קוד מפתח חדש?
ההחלטה אם להירשם לטוקן מפתח חדש תלויה בכמה גורמים. הנה כמה מהתרחישים הנפוצים:
תרחיש
השלבים הבאים
החברה שלכם מעולם לא השתמשה ב-Google Ads API ואתם רוצים לפתח אפליקציות משלכם
החברה שלכם משתמשת באופן פעיל ב-Google Ads API או השתמשה בו בעבר
בדרך כלל Google מעניקה קוד מפתח אחד לכל חברה, לכן אם החברה שלכם כבר משתמשת ב-Google Ads API, עליכם להשתמש מחדש בקוד המפתח הקיים. מידע נוסף
החברה שלכם כבר משתמשת ב-Google Ads API, אבל מפתחת גם מוצר או כלי חדש
אם אתם בטוחים שאי אפשר להשתמש באסימון הקיים למפתחים, אתם יכולים להגיש בקשה לאסימון חדש ולפרט בבקשה את התרחיש לדוגמה.
בשאר המדריך הזה, אפשר להשתמש באסימון המפתח הקיים. מידע נוסף
החברה שלכם משתמשת באפליקציה של צד שלישי
אתם צריכים קוד מפתח רק אם אתם מפתחים אפליקציה משלכם. אם אתם משתמשים באפליקציה או בשירות של צד שלישי, המפתח של האפליקציה הזו צריך לקבל קוד מפתח בשביל האפליקציה. אם אתם לא בטוחים מה המצב שלכם, צרו קשר עם צוות התאימות ל-API.
איך מגישים בקשה לקוד מפתח
תהליך הגשת הבקשה לקוד מפתח כולל שני שלבים.
שלב 1: בוחרים או יוצרים חשבון ניהול ב-Google Ads
אם כבר יש לכם חשבון ניהול ב-Google Ads, אתם יכולים לבחור אותו כשאתם שולחים בקשה לקבלת הטוקן. אם חשבון הניהול הזה עדיין לא מקושר לחשבונות האחרים שלכם, מומלץ למקם אותו בבסיס של היררכיית החשבונות כדי להקל על תהליך הבדיקה של האסימון ולפשט את ניהול החשבון בהמשך.
אם אין לכם חשבון ניהול, תוכלו לפעול לפי ההוראות במרכז העזרה כדי ליצור חשבון כזה.
שלב 2: שולחים בקשה לגישה אל Google Ads API
לתשומת ליבך, תהליך הבדיקה של אסימון המפתח עשוי להימשך זמן מה.
מידע נוסף
ממלאים את הטופס של גישה ל-API ומאשרים את התנאים וההגבלות.
חשוב לוודא שהמידע נכון ושהכתובת של אתר החברה פועלת. אם האתר לא פעיל, יכול להיות ש-Google לא תוכל לעבד את הבקשה שלכם ותדחה אותה.
חשוב לוודא שכתובת האימייל ליצירת קשר בנושא API שציינתם מובילה לתיבת דואר נכנס שנבדקת באופן קבוע. צוות התאימות של Google ל-API עשוי ליצור קשר עם כתובת האימייל הזו במהלך תהליך הבדיקה כדי לקבל הבהרות. אם לא נוכל ליצור איתך קשר, יכול להיות ש-Google לא תמשיך בתהליך הבקשה.
אפשר לערוך את כתובת האימייל של איש הקשר בנושא API במרכז ה-API. חשוב לשמור את המידע הזה מעודכן, גם אחרי תהליך הגשת הבקשה, כדי ש-Google תוכל לשלוח לכם הודעות חשובות בנוגע לשירות.
אחרי שמסיימים את תהליך הגשת הבקשה, קוד המפתח מופיע במרכז ה-API עם הסטטוס Pending Approval (בהמתנה לאישור). קוד המפתח שלך קיבל עכשיו רמה של גישה לחשבון בדיקה, ואפשר להתחיל לבצע קריאות ל-API מול חשבונות בדיקה.
אחרי שמקבלים את קוד המפתח, חשוב לשים לב לערך שלו כי תצטרכו אותו כשתיצרו את קריאת ה-API הראשונה.
איך בודקים אם מחוברים לחשבון ניהול
כדי לגשת לקוד המפתח, צריך להיכנס לחשבון הניהול. אי אפשר להשתמש בחשבון ניהול לצורך בדיקה.
[[["התוכן קל להבנה","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\u003eA developer token, a 22-character alphanumeric string, is required to connect your app to the Google Ads API and can be created or viewed in the API Center of your Google Ads manager account.\u003c/p\u003e\n"],["\u003cp\u003eDeveloper tokens have access levels that dictate daily API call limits and environments; Basic or Standard Access is needed for production accounts.\u003c/p\u003e\n"],["\u003cp\u003eYou likely need a new developer token if your company is new to the Google Ads API or developing a new product requiring separate access, while existing users should generally reuse their company's current token.\u003c/p\u003e\n"],["\u003cp\u003eApplying for a developer token involves selecting/creating a Google Ads manager account and completing the API Access form, which may involve a review period before granting access.\u003c/p\u003e\n"],["\u003cp\u003eAfter obtaining the developer token, locate it in the API Center of your Google Ads manager account and securely store it for use in API calls.\u003c/p\u003e\n"]]],[],null,["# Obtain a developer token\n\n| **Key Point:** A developer token is a prerequisite to making your first API call. After you obtain the token, make sure to note its value for the next steps.\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThe **developer token** is a 22-character long alphanumeric string that lets\nyour app connect to the Google Ads API. After the token is assigned to you by Google,\nyou can view it or create a new one on the **API Center** page of your Google Ads\nmanager account.\n\nEach developer token is assigned an [access level](/google-ads/api/docs/access-levels#access_levels_2) which\ncontrols the number of API calls you can make per day with the token, as well\nas the environment to which you can make calls.\n\nTo make API calls against your production account, you must request\n**Basic Access** level or **Standard Access** level for your developer token\nduring the token application process. Since these access levels are not required\nto make calls against test accounts, you can proceed with the exercises, but\nyou're encouraged to check out [how to apply for Basic\nAccess level](/google-ads/api/docs/access-levels#applying_for_basic_access) after you've completed this guide.\n\nDo you need a new developer token?\n----------------------------------\n\nWhether you should sign up for a new developer token or not depends on a few\nfactors. Here are some common scenarios:\n\n|---------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ##### Scenario | ##### Next steps |\n| Your company has never used the Google Ads API before and you want to develop your own apps | Sign up for a new developer token. [Learn more](#apply-token) |\n| Your company is actively using or has used the Google Ads API in the past | Google usually grants one developer token per company, so if your company already uses the Google Ads API, then you should reuse your existing developer token. [Learn more](#find-token) |\n| Your company already uses the Google Ads API but is also developing a new product or tool | If you're certain that you cannot use your existing developer token, then you can apply for a new one explaining your use case in the application. For the rest of this guide, you can use your existing developer token. [Learn more](#apply-token) |\n| Your company uses a third-party app | You need a developer token only if you're developing your own app. If you use a third-party app or service, then the developer of that app needs to get a developer token for the app. If you're unclear about your case, [contact the API compliance team](//support.google.com/adspolicy/contact/contact_ads_api). |\n\nHow to apply for a developer token\n----------------------------------\n\nThere are two steps when applying for a developer token.\n\n### Step 1: Select or create a Google Ads manager account\n\nIf you already have a Google Ads manager account, select it when applying for the\ntoken. If this manager account is not already linked to your other accounts, we\nrecommend putting it at the root of your account hierarchy to ease the token\nreview process and simplify account management later on.\n\nIf you don't have a manager account, you can follow the [Help Center\ninstructions](//support.google.com/google-ads/answer/7459399) to create one.\n| **Note:** You must use an email address that hasn't already been associated with a Google Ads account to create your manager account.\n\n### Step 2: Apply for access to the Google Ads API\n\nNote that the developer token review process can take some time to complete.\n[Learn more](/google-ads/api/docs/productionize/access-levels).\n\n1. Navigate to\n [https://ads.google.com/aw/apicenter](//ads.google.com/aw/apicenter)\n in your web browser. Sign in to your Google Ads manager account if prompted.\n\n [Access API Center](//ads.google.com/aw/apicenter)\n2. Complete the API Access form and accept the Terms and Conditions.\n\n- Ensure that your information is correct and your company's website\n URL is functioning. If the website is not live, Google might not be able to\n process your application and reject it.\n\n- Ensure that the API contact email you provide leads to a regularly monitored\n inbox. Google's API compliance team might reach out to this email address\n during the review process for clarifications. If you can't be reached, Google\n might not continue with your application.\n\n You can edit your **API contact email** in the **API Center**. Keep this\n information up-to-date, even after the application process, so Google can send\n you important service announcements.\n\nAfter you've completed the application process, the developer token appears in\nyour API Center with a **Pending Approval** status. Your developer token now has\n**Test Account Access** level and you can start making API calls against [test\naccounts](/google-ads/api/docs/best-practices/test-accounts).\n\nAfter you've obtained your developer token, note its value as you will require\nit when making your first API call.\n\nVerify if you are signed into a manager account\n-----------------------------------------------\n\nYou must sign in to your manager account to access your developer token, and it\ncannot be a test manager account.\n\nTo verify if you are signed in to the manager account, follow these steps:\n\n1. Navigate to\n [https://ads.google.com/aw/apicenter](//ads.google.com/aw/apicenter)\n in your web browser.\n\n2. If you are logged into a customer account, the page will display\n **The API Center is only available to manager accounts.**.\n\n3. If **Test account** appears in red in the upper right corner, your account is\n either\n [a test manager or a test advertiser](/google-ads/api/docs/best-practices/test-accounts).\n\nWhere to find your developer token\n----------------------------------\n\nYou can find the developer token, if it exists, in the **API Center** page of\nyour Google Ads manager account.\n\n[Access API Center](https://ads.google.com/aw/apicenter)"]]
