این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

مدیر اندازه گیری

public class MeasurementManager
extends Object

java.lang.object
↳	android.adservices.measurement.MeasurementManager

MeasurementManager APIهایی را برای مدیریت منبع و ثبت‌های راه‌انداز فراهم می‌کند.

خلاصه

ثابت ها
`int`	`MEASUREMENT_API_STATE_DISABLED` این حالت نشان می دهد که API های اندازه گیری در دسترس نیستند.
`int`	`MEASUREMENT_API_STATE_ENABLED` این حالت نشان می دهد که API های اندازه گیری فعال هستند.

روش های عمومی
`void`	`deleteRegistrations ( DeletionRequest deletionRequest, Executor executor, OutcomeReceiver < Object , Exception > callback)` حذف ثبت نام های قبلی
`static MeasurementManager`	`get ( Context context)` روش کارخانه برای ایجاد یک نمونه از MeasurementManager.
`void`	`getMeasurementApiStatus ( Executor executor, OutcomeReceiver < Integer , Exception > callback)` وضعیت Measurement API را دریافت کنید.
`void`	`registerSource ( Uri attributionSource, InputEvent inputEvent, Executor executor, OutcomeReceiver < Object , Exception > callback)` یک منبع انتساب را ثبت کنید (کلیک کنید یا مشاهده کنید).
`void`	`registerSource ( SourceRegistrationRequest request, Executor executor, OutcomeReceiver < Object , Exception > callback)` منابع انتساب (کلیک یا مشاهده) را از یک زمینه برنامه ثبت کنید.
`void`	`registerTrigger ( Uri trigger, Executor executor, OutcomeReceiver < Object , Exception > callback)` ثبت یک ماشه (تبدیل).
`void`	`registerWebSource ( WebSourceRegistrationRequest request, Executor executor, OutcomeReceiver < Object , Exception > callback)` یک منبع انتساب (کلیک کنید یا مشاهده کنید) را از زمینه وب ثبت کنید.
`void`	`registerWebTrigger ( WebTriggerRegistrationRequest request, Executor executor, OutcomeReceiver < Object , Exception > callback)` یک عامل انتساب (کلیک کنید یا مشاهده کنید) را از زمینه وب ثبت کنید.

روش های ارثی

از کلاس java.lang.Object

`Object`	`clone ()` یک کپی از این شی را ایجاد و برمی گرداند.
`boolean`	`equals ( Object obj)` نشان می دهد که آیا یک شی دیگر "برابر" این یکی است یا خیر.
`void`	`finalize ()` هنگامی که جمع‌آوری زباله مشخص می‌کند که دیگر ارجاعی به آن شی وجود ندارد، توسط زباله‌گیر بر روی یک شی فراخوانی می‌شود.
`final Class <?>`	`getClass ()` کلاس زمان اجرا این `Object` را برمی گرداند.
`int`	`hashCode ()` مقدار کد هش را برای شی برمی‌گرداند.
`final void`	`notify ()` یک رشته را که در مانیتور این شیء منتظر است بیدار می کند.
`final void`	`notifyAll ()` تمام رشته هایی که در مانیتور این شیء منتظر هستند را بیدار می کند.
`String`	`toString ()` یک نمایش رشته ای از شی را برمی گرداند.
`final void`	`wait (long timeoutMillis, int nanos)` باعث می‌شود تا رشته فعلی منتظر بماند تا بیدار شود، معمولاً با اطلاع یا قطع شدن ، یا تا زمانی که مقدار مشخصی از زمان واقعی سپری شود.
`final void`	`wait (long timeoutMillis)` باعث می‌شود تا رشته فعلی منتظر بماند تا بیدار شود، معمولاً با اطلاع یا قطع شدن ، یا تا زمانی که مقدار مشخصی از زمان واقعی سپری شود.
`final void`	`wait ()` باعث می شود تا رشته فعلی منتظر بماند تا بیدار شود، معمولاً با اطلاع یا قطع شدن .

ثابت ها

MEASUREMENT_API_STATE_DISABLED

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public static final int MEASUREMENT_API_STATE_DISABLED

این حالت نشان می دهد که API های اندازه گیری در دسترس نیستند. فراخوانی آنها منجر به UnsupportedOperationException می شود.

مقدار ثابت: 0 (0x00000000)

MEASUREMENT_API_STATE_ENABLED

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public static final int MEASUREMENT_API_STATE_ENABLED

این حالت نشان می دهد که API های اندازه گیری فعال هستند.

مقدار ثابت: 1 (0x00000001)

روش های عمومی

حذف ثبت ها

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void deleteRegistrations (DeletionRequest deletionRequest, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

حذف ثبت نام های قبلی اگر حذف موفقیت آمیز باشد، OutcomeReceiver.onResult(R) پاسخ تماس با null فراخوانی می شود. در صورت خرابی، یک Exception از طریق فراخوانی OutcomeReceiver#onError ارسال می شود. بازخورد موفقیت و شکست هر دو بر روی Executor ارائه شده اجرا می شود.

پارامترها
`deletionRequest`	`DeletionRequest` : درخواست حذف داده ها. این مقدار نمی تواند `null` باشد.
`executor`	`Executor` : مجری برای اجرای callback. این مقدار نمی تواند `null` باشد. رویدادهای پاسخ به تماس و شنونده از طریق این `Executor` ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از `Context.getMainExecutor()` استفاده کنید. در غیر این صورت، یک `Executor` ارائه دهید که به یک موضوع مناسب ارسال می کند.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار نمی تواند `null` باشد.

دریافت کنید

در سطح API 34 اضافه شده است
همچنین در برنامه های افزودنی Ad Services 6

public static MeasurementManager get (Context context)

روش کارخانه برای ایجاد یک نمونه از MeasurementManager.

پارامترها
`context`	`Context` : `Context` استفاده این مقدار نمی تواند `null` باشد.

برمی گرداند
`MeasurementManager`	یک نمونه `MeasurementManager` این مقدار نمی تواند `null` باشد.

getMeasurementApiStatus

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void getMeasurementApiStatus (Executor executor, 
                OutcomeReceiver<Integer, Exception> callback)

وضعیت Measurement API را دریافت کنید.

مقدار Integer Callback یکی از MeasurementApiState است.
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها

پارامترها
`executor`	`Executor` : برای ارسال نتایج توسط پاسخ تماس استفاده می شود. این مقدار نمی تواند `null` باشد. رویدادهای پاسخ به تماس و شنونده از طریق این `Executor` ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از `Context.getMainExecutor()` استفاده کنید. در غیر این صورت، یک `Executor` ارائه دهید که به یک موضوع مناسب ارسال می کند.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار نمی تواند `null` باشد.

executor

Executor : برای ارسال نتایج توسط پاسخ تماس استفاده می شود. این مقدار نمی تواند null باشد. رویدادهای پاسخ به تماس و شنونده از طریق این Executor ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از Context.getMainExecutor() استفاده کنید. در غیر این صورت، یک Executor ارائه دهید که به یک موضوع مناسب ارسال می کند.

callback

OutcomeReceiver : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار نمی تواند null باشد.

منبع ثبت نام

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void registerSource (Uri attributionSource, 
                InputEvent inputEvent, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

یک منبع انتساب را ثبت کنید (کلیک کنید یا مشاهده کنید).
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها
`attributionSource`	`Uri` : پلتفرم درخواستی را به این URI ارسال می کند تا فراداده مرتبط با منبع انتساب را واکشی کند. فراداده منبع در دستگاه ذخیره می‌شود، که واجد شرایط تطبیق با محرک‌های آینده است. این مقدار نمی تواند `null` باشد.
`inputEvent`	`InputEvent` : یا یک شی `InputEvent` (برای یک رویداد کلیک) یا null (برای یک رویداد مشاهده).
`executor`	`Executor` : برای ارسال نتایج توسط پاسخ تماس استفاده می شود. این مقدار ممکن است `null` باشد. رویدادهای پاسخ به تماس و شنونده از طریق این `Executor` ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از `Context.getMainExecutor()` استفاده کنید. در غیر این صورت، یک `Executor` ارائه دهید که به یک موضوع مناسب ارسال می کند.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار ممکن است `null` باشد.

پرتاب می کند
`IllegalArgumentException`	اگر طرح `attributionSource` HTTPS نباشد

منبع ثبت نام

در Android UpsideDownCakePrivacySandbox اضافه شد
همچنین در Ad Services Extensions 4

public void registerSource (SourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

منابع انتساب (کلیک یا مشاهده) را از یک زمینه برنامه ثبت کنید. این API هیچ تغییر مسیری را پردازش نمی کند، همه URL های ثبت نام باید همراه با درخواست ارائه شوند.
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها
`request`	`SourceRegistrationRequest` : درخواست ثبت منبع برنامه این مقدار نمی تواند `null` باشد.
`executor`	`Executor` : برای ارسال نتایج توسط تماس برگشتی استفاده می شود این مقدار ممکن است `null` باشد. رویدادهای پاسخ به تماس و شنونده از طریق این `Executor` ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از `Context.getMainExecutor()` استفاده کنید. در غیر این صورت، یک `Executor` ارائه دهید که به یک موضوع مناسب ارسال می کند.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API این مقدار ممکن است `null` باشد.

registerTrigger

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void registerTrigger (Uri trigger, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

ثبت یک ماشه (تبدیل).
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها
`trigger`	`Uri` : API درخواستی برای این URI برای واکشی ابرداده مرتبط با تریگر صادر می کند. فراداده راه‌انداز در دستگاه ذخیره می‌شود و واجد شرایط تطبیق با منابع در طول فرآیند انتساب است. این مقدار نمی تواند `null` باشد.
`executor`	`Executor` : برای ارسال نتایج توسط پاسخ تماس استفاده می شود. این مقدار ممکن است `null` باشد. رویدادهای پاسخ به تماس و شنونده از طریق این `Executor` ارسال می‌شوند و راهی آسان برای کنترل رشته مورد استفاده ارائه می‌دهند. برای ارسال رویدادها از طریق رشته اصلی برنامه خود، می توانید از `Context.getMainExecutor()` استفاده کنید. در غیر این صورت، یک `Executor` ارائه دهید که به یک موضوع مناسب ارسال می کند.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار ممکن است `null` باشد.

پرتاب می کند
`IllegalArgumentException`	اگر طرح `trigger` HTTPS نباشد

registerWebSource

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void registerWebSource (WebSourceRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

یک منبع انتساب (کلیک کنید یا مشاهده کنید) را از زمینه وب ثبت کنید. این API هیچ تغییر مسیری را پردازش نمی کند، همه URL های ثبت نام باید همراه با درخواست ارائه شوند. حداقل یکی از پارامترهای appDestination یا webDestination باید ارائه شود. اگر ثبت نام موفقیت آمیز باشد، callback OutcomeReceiver#onResult با null فراخوانی می شود. در صورت خرابی، یک Exception از طریق OutcomeReceiver.onError(E) callback ارسال می شود. بازخورد موفقیت و شکست هر دو بر روی Executor ارائه شده اجرا می شود.
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها
`request`	`WebSourceRegistrationRequest` : درخواست ثبت منبع این مقدار نمی تواند `null` باشد.
`executor`	`Executor` : برای ارسال نتایج توسط پاسخ تماس استفاده می شود. این مقدار ممکن است `null` باشد.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API. این مقدار ممکن است `null` باشد.

registerWebTrigger

در سطح API 34 اضافه شده است
همچنین در Ad Services Extensions 4

public void registerWebTrigger (WebTriggerRegistrationRequest request, 
                Executor executor, 
                OutcomeReceiver<Object, Exception> callback)

یک عامل انتساب (کلیک کنید یا مشاهده کنید) را از زمینه وب ثبت کنید. این API هیچ تغییر مسیری را پردازش نمی کند، همه URL های ثبت نام باید همراه با درخواست ارائه شوند. اگر ثبت نام موفقیت آمیز باشد، callback OutcomeReceiver#onResult با null فراخوانی می شود. در صورت خرابی، یک Exception از طریق OutcomeReceiver.onError(E) callback ارسال می شود. بازخورد موفقیت و شکست هر دو بر روی Executor ارائه شده اجرا می شود.
به AdServicesPermissions.ACCESS_ADSERVICES_ATTRIBUTION نیاز دارد.ACCESS_ADSERVICES_ATTRIBUTION

پارامترها
`request`	`WebTriggerRegistrationRequest` : درخواست ثبت ماشه این مقدار نمی تواند `null` باشد.
`executor`	`Executor` : برای ارسال نتایج توسط تماس برگشتی استفاده می شود این مقدار ممکن است `null` باشد.
`callback`	`OutcomeReceiver` : در نظر گرفته شده برای اطلاع رسانی ناهمزمان نتیجه API این مقدار ممکن است `null` باشد.