پیش‌نیازها

یک حساب Google ایجاد کنید

برای ایجاد پروژه در «کنسول Google API» به حساب Google نیاز دارید. اگر ازقبل حساب دارید، همه چیز آماده است.

همچنین ممکن است برای اهداف آزمایش به «حساب Google» جداگانه‌ای نیاز داشته باشید.

امتحان کردن Google AdMob

این مستندات API فرض می‌کند که شما از Google AdMob استفاده کرده‌اید و با مفاهیم برنامه‌نویسی وب و قالب‌های داده وب آشنا هستید.

اگر از Google AdMob استفاده نکرده‌اید، قبل‌از شروع کدنویسی، واسط کاربر را امتحان کنید.

ایجاد پروژه برای مشتری

قبل‌از اینکه بتوانید درخواست‌هایی را به Google AdMob ارسال کنید، باید به Google درباره کارخواهتان بگویید و دسترسی به «میانای برنامه‌سازی کاربردی» را فعال کنید. این کار را بااستفاده از «کنسول Google API» برای ایجاد پروژه انجام می‌دهید. پروژه مجموعه‌ای نام‌گذاری‌شده از تنظیمات و اطلاعات دسترسی به API است و برنامه خود را ثبت می‌کنید.

برای شروع استفاده از AdMob API، ابتدا باید از ابزار راه‌اندازی استفاده کنید که شما را در ایجاد پروژه در «کنسول Google API» و فعال کردن API راهنمایی می‌کند.

آشنایی با اصول اولیه REST

‫REST سبکی از معماری نرم‌افزار است که رویکردی راحت و یکنواخت برای درخواست و اصلاح داده‌ها ارائه می‌دهد.

اصطلاح REST مخفف «انتقال وضعیت نمایشی» است. در زمینه «میاناهای برنامه‌سازی کاربردی Google»، به استفاده از فعل‌های HTTP برای بازیابی و اصلاح نمایش‌های داده‌های ذخیره‌شده توسط Google اشاره دارد.

در سیستم RESTful، منابع در یک فروشگاه داده ذخیره می‌شوند؛ مشتری درخواستی ارسال می‌کند که سرور کنش خاصی را انجام دهد (مثل ایجاد، بازیابی، به‌روزرسانی، یا حذف منبع)، و سرور کنش را انجام می‌دهد و پاسخی ارسال می‌کند که اغلب به‌صورت نمایش منبع مشخص‌شده است.

در «میاناهای برنامه‌سازی کاربردی RESTful» از Google، کارخواه کنشی را بااستفاده از فعل HTTP مثل POST،‏ GET،‏ PUT، یا DELETE مشخص می‌کند. منبع را با یک شناسه منبع یکسان (URI) جهانی منحصربه‌فرد به شکل زیر مشخص می‌کند:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

ازآنجایی‌که همه منابع API دارای نشانی‌های وب یکتای قابل‌دسترس ازطریق HTTP هستند، «آرام» امکان ذخیره داده‌ها در حافظه نهان را فراهم می‌کند و برای کار با زیرساخت توزیع‌شده وب بهینه‌سازی شده است.

ممکن است تعاریف روش در مستندات استانداردهای HTTP 1.1 برایتان مفید باشد؛ این مستندات شامل مشخصات GET، POST، PUT، و DELETE است.

‫REST در «میانای برنامه‌سازی کاربردی AdMob»

عملکردهای AdMob API مستقیماً به فعل‌های REST HTTP مربوط می‌شوند.

قالب‌های خاص برای نشانی‌های وب AdMob API عبارت‌اند از:

https://admob.googleapis.com/v1/resourcePath?parameters

مجموعه کامل نشانی‌های وب استفاده‌شده برای هر عملیات پشتیبانی‌شده در API در سند مرجع AdMob API خلاصه شده است.

آشنایی با اصول اولیه JSON

«میانای برنامه‌سازی کاربردی AdMob» داده‌ها را در قالب JSON برمی‌گرداند.

JSON (نشان‌گذاری شیء جاوا اسکریپت) یک قالب داده رایج و مستقل از زبان است که نمایش نوشتاری ساده‌ای از ساختارهای داده دلخواه ارائه می‌دهد. برای اطلاعات بیشتر، به json.org مراجعه کنید.