با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
همه تماس‌های Google AdMob API باید از طریق OAuth2 مجاز باشند تا برنامه شما بتواند از طرف کاربر با سرویس‌های وب تعامل داشته باشد. OAuth2 برنامه سرویس گیرنده AdMob API شما را قادر می سازد تا بدون نیاز به مدیریت یا ذخیره نام کاربری یا رمز عبور کاربر، به حساب AdMob کاربر دسترسی داشته باشد. برای یک نمای کلی از مجوز، به مجوز مراجعه کنید.
مراحل زیر را برای ایجاد اعتبارنامه OAuth2 و اولین درخواست خود انجام دهید.
جدول زیر را بررسی کنید تا ببینید کدام نوع احراز هویت برای برنامه شما مناسب‌تر است:
نوع احراز هویت OAuth2 خود را انتخاب کنید
اگر...
برنامه دسکتاپ
شما با استفاده از یک حساب مدیر سطح بالا، همه حساب‌های AdMob API خود را مدیریت می‌کنید.
شما برای اولین بار کاربر هستید یا می خواهید با ساده ترین راه اندازی سریع شروع کنید.
برنامه شما فقط کاربران Google AdMob را از یک دستگاه احراز هویت می کند.
برنامه وب
می‌خواهید به‌عنوان کاربری که می‌تواند به برنامه شما اجازه دسترسی به داده‌های حساب AdMob API خود را بدهد، احراز هویت شوید.
شما می خواهید به راحتی چندین اعتبار مجوز تولید کنید، به عنوان مثال، حساب های شخص ثالث را مدیریت کنید.
برنامه شما به URL های پاسخ به تماس نیاز دارد. URL های پاسخ به تماس در جریان برنامه دسک تاپ پشتیبانی نمی شوند.
یک پروژه ایجاد کنید
برای شروع استفاده از AdMob API، ابتدا باید یک پروژه را در Google API Console ایجاد یا انتخاب کنید و API را با استفاده از ابزار setup فعال کنید، که شما را در طول فرآیند راهنمایی می‌کند و AdMob API را به‌طور خودکار فعال می‌کند.
فعال کردن API برای یک پروژه موجود
مراحل زیر برای کاربرانی اعمال می شود که یک پروژه موجود دارند و ترجیح می دهند AdMob API را به صورت دستی برای آن فعال کنند.
If prompted, select a project, or create a new one. را API Library همه API های موجود را فهرست می کند که بر اساس خانواده محصول و محبوبیت گروه بندی شده اند.
اگر API که می‌خواهید فعال کنید در لیست قابل مشاهده نیست، از جستجو برای پیدا کردن آن استفاده کنید یا روی مشاهده همه در خانواده محصولی که به آن تعلق دارد کلیک کنید.
API را که می خواهید فعال کنید انتخاب کنید، سپس روی دکمه Enable کلیک کنید.
If prompted, enable billing.
If prompted, read and accept the API's Terms of Service.
اعتبارنامه OAuth2 را ایجاد کنید
دستورالعمل‌های زیر شما را در فرآیند ایجاد شناسه مشتری OAuth 2.0 برای استفاده با جریان برنامه نصب شده راهنمایی می‌کند.
اگر قبلاً صفحه رضایت OAuth را برای این پروژه پیکربندی نکرده بودید، اکنون به شما دستور داده می شود که این کار را انجام دهید. روی پیکربندی صفحه رضایت کلیک کنید. راه‌های مختلفی برای پیکربندی صفحه رضایت برای استفاده از شناسه مشتری OAuth 2.0 وجود دارد.
نوع کاربری خود را روی خارجی و وضعیت انتشار را روی Published تنظیم کنید.
یا، نوع کاربری خود را روی External و وضعیت انتشار را روی Testing تنظیم کنید، سپس با انتخاب add users، کاربران آزمایشی را اضافه کنید تا به آنها دسترسی داشته باشید تا از شناسه مشتری OAuth 2.0 خود استفاده کنند.
برنامه Desktop یا Web Application را به عنوان نوع برنامه انتخاب کنید، نامی به آن بدهید، سپس روی ایجاد کلیک کنید.
پس از اتمام، یک شناسه مشتری OAuth 2.0 و راز سرویس گیرنده به شما ارائه می شود که می توانید آنها را در قالب JSON دانلود کرده و برای استفاده بعدی ذخیره کنید.
درخواست بدهید
AdMob API بر روی HTTP و JSON ساخته شده است، بنابراین هر سرویس گیرنده HTTP استاندارد می تواند درخواست ها را به آن ارسال کند و پاسخ ها را تجزیه کند. با این حال، کتابخانه های سرویس گیرنده Google API یکپارچه سازی زبان بهتر، امنیت بهبود یافته و پشتیبانی از درخواست های مجاز را ارائه می دهند. کتابخانه های سرویس گیرنده در تعدادی از زبان های برنامه نویسی در دسترس هستند. با استفاده از آنها می توانید از نیاز به تنظیم دستی درخواست های HTTP و تجزیه پاسخ ها اجتناب کنید.
با ایجاد اعتبارنامه OAuth 2.0 ، آماده شروع استفاده از AdMob API هستید. برای درخواست دسترسی با استفاده از OAuth 2.0، برنامه شما همچنین به اطلاعات محدوده نیاز دارد:
دامنه
معنی
https://www.googleapis.com/auth/admob.readonly
همه داده‌های AdMob را ببینید. این ممکن است شامل اطلاعات حساب، تنظیمات موجودی و میانجیگری، گزارش‌ها و سایر داده‌ها باشد. این شامل داده‌های حساس، مانند پرداخت‌ها یا جزئیات کمپین نمی‌شود.
https://www.googleapis.com/auth/admob.report
گزارش عملکرد تبلیغات و درآمد را مشاهده کنید. شناسه ناشر، منطقه زمانی و کد ارز پیش‌فرض را ببینید.
اولین درخواست خود را برای ایجاد گزارش با استفاده از مثال هایی در جاوا ، پی اچ پی ، پایتون یا کرل ارائه دهید.
توکن های مشترک را باطل کنید
شما می توانید توکن های مشترک را به دو روش لغو کنید:
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAll Google AdMob API calls require OAuth2 authorization for your app to access user data securely without storing sensitive login credentials.\u003c/p\u003e\n"],["\u003cp\u003eChoose between desktop or web app authentication flow based on your app's needs and authorization process.\u003c/p\u003e\n"],["\u003cp\u003eCreate or select a Google API project and enable the AdMob API before generating OAuth2 credentials.\u003c/p\u003e\n"],["\u003cp\u003eMake authorized requests to the AdMob API using HTTP clients or client libraries in various programming languages.\u003c/p\u003e\n"],["\u003cp\u003eRevoke access tokens through your Google account permissions or the Google Identity API when necessary.\u003c/p\u003e\n"]]],["To use the Google AdMob API, authorize calls via OAuth2. First, create or select a project in the Google API Console and enable the AdMob API. Next, create OAuth2 credentials, choosing between \"Desktop app\" or \"Web app\" authentication types based on your needs. Configure the OAuth consent screen, download the generated client ID and secret, and then use these credentials to authorize requests with specified scopes, such as `admob.monetization` or `admob.readonly`. To start making requests, you can utilize the Google API client libraries. If you want to revoke access, you can do so from your Google account or using Google Identity API.\n"],null,["All Google AdMob API calls must be authorized through\n[OAuth2](/identity/protocols/oauth2) so your app can interact with web services\non the user's behalf. OAuth2 enables your AdMob API client app to access a\nuser's AdMob account without having to handle or store the user's username or\npassword. For an overview of authorization, see\n[Authorization](/admob/api/v1/how-tos/authorizing).\n\nPerform the following steps to generate the OAuth2 credentials and make your\nfirst request.\n\nPrerequisites\n\n- A [Google Account](//google.com/accounts/NewAccount).\n\n- A [Google AdMob account](//admob.google.com/home/get-started).\n\n- Familiarity with [REST basics](/admob/api/v1/prereqs#rest) and [authorizing requests with\n OAuth 2.0](/admob/api/v1/how-tos/authorizing).\n\nDetermine your authentication type\n\nCheck the table below to see which **authentication type** is most appropriate\nfor your app:\n\n| Choose your OAuth2 authentication type | If ... |\n|----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Desktop app** | - You're managing all of your AdMob API accounts using a single top level manager account. - You're a first-time user, or want to get started quickly with the simplest setup. - Your app only authenticates Google AdMob users from one machine. |\n| **Web app** | - You want to authenticate as a user who can grant permission to your app to access their AdMob API account data. - You want to easily generate multiple authorization credentials, to manage third-party accounts for example. - Your app requires callback URLs. Callback URLs are not supported in the desktop app flow. |\n\n| **Key Point:** You can still choose the desktop app flow even if you're developing an app to run on a server. The difference is whether the OAuth authorization is completed locally or remotely. A desktop flow requires authorization to be completed on the local machine, whereas the web-flow lets authorization be completed on Google's authorization server.\n\nCreate a project\n\nTo get started using the AdMob API, you need to first create or select a\nproject in the Google API Console and enable the API using [the setup\ntool](https://console.cloud.google.com/start/api?id=admob.googleapis.com&credential=client_key),\nwhich guides you through the process and activates the AdMob API\nautomatically. \n\nEnabling the API for an existing project\n\nThe following steps apply to users who have an existing project and prefer to\nactivate the AdMob API for it manually.\n\nTo enable an API for your project:\n\n1. [Open the API Library](https://console.developers.google.com/apis/library) in the Google API Console.\n2. If prompted, select a project, or create a new one. The API Library lists all available APIs, grouped by product family and popularity.\n3. If the API you want to enable isn't visible in the list, use search to find it, or click **View All** in the product family it belongs to.\n4. Select the API you want to enable, then click the **Enable** button.\n5. If prompted, enable billing.\n6. If prompted, read and accept the API's Terms of Service.\n\nCreate OAuth2 credentials\n\nThe following instructions guide you through the process of creating an OAuth\n2.0 client ID to use with the [installed app\nflow](/identity/protocols/OAuth2InstalledApp).\n\n1. Go to the [Clients page](https://console.developers.google.com/auth/clients).\n2. Click **CREATE CREDENTIALS \\\u003e OAuth client ID**.\n\n If you hadn't configured an OAuth consent screen for this project\n previously, you'll be directed to do so now. Click **CONFIGURE CONSENT\n SCREEN**. There are multiple ways to configure your consent screen to\n use your OAuth 2.0 client ID.\n 1. Set your user type to **External** and publishing status to **Published**.\n 2. Or, set your user type to **External** and publishing status to\n **Testing** , then add **Test users** by selecting **add users** to\n give them access to use your OAuth 2.0 client ID.\n\n See additional information on [setting up your OAuth consent\n screen](//support.google.com/cloud/answer/10311615).\n3. Select **Desktop app** or **Web Application** as the application type, give\n it a name, then click **Create**.\n\nWhen done, you are presented with an OAuth 2.0 client ID and client secret,\nwhich you can download in JSON format and save for later use.\n\nMake a request\n\nThe AdMob API is built on HTTP and JSON, so any standard HTTP client can send\nrequests to it and parse the responses. However, the [Google API client\nlibraries](/admob/api/v1/libraries) provide better language integration,\nimproved security, and support for making authorized requests. The client\nlibraries are available in a number of programming languages; by using them you\ncan avoid the need to manually set up HTTP requests and parse the responses.\n| **Note:** The first time you activate the OAuth flow, you are asked to provide your AdMob publisher ID and accept an authorization prompt in your browser. Before accepting, make sure you're signed in with a Google Account that has access to your AdMob account. Your app is then authorized to access data on behalf of whichever account is currently logged in.\n\nWith [OAuth 2.0 credentials created](#credentials), you're ready to start using\nthe AdMob API. To request access using OAuth 2.0, your app also needs scope\ninformation:\n\n\n| Scope | Meaning |\n|--------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `https://www.googleapis.com/auth/admob.readonly` | See all AdMob data. This may include account information, inventory and mediation settings, reports, and other data. This doesn't include sensitive data, such as payments or campaign details. |\n| `https://www.googleapis.com/auth/admob.report` | See ad performance and earnings reports. See publisher ID, timezone, and default currency code. |\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nMake your first request to generate a report using examples in\n[Java](/admob/api/v1/reporting#java-client-library),\n[PHP](/admob/api/v1/reporting#php-client-library),\n[Python](/admob/api/v1/reporting#python-client-library) or\n[curl](/admob/api/v1/reporting#curl-command-line).\n\nRevoke shared tokens\n\nYou can revoke shared tokens in two ways:\n\n1. Navigate to your [Google account\n permissions page](//myaccount.google.com/permissions) and revoke access from\n the relevant project.\n\n2. Alternatively, you can revoke web application tokens using the [Google\n Identity API](/identity/protocols/oauth2/web-server#tokenrevoke)."]]
