Google Workspace Directory API به شما امکان می دهد دستگاه های تلفن همراه را در سازمان خود مدیریت کنید. این صفحه شامل نمونه هایی از نحوه فهرست کردن دستگاه های تلفن همراه، به دست آوردن جزئیات یک دستگاه خاص، و همچنین افزودن یا حذف یک دستگاه است.
این سند فرض می کند که شما پیش نیازها را با موفقیت تکمیل کرده اید. دستگاههای Android باید برنامه سیاست دستگاه را نصب کرده باشند. دستگاههای iOS باید در سرویس Google Mobile Management ثبت نام کرده باشند.
در این مثالها، متغیرهای customerId و resourceId برای نشان دادن محل ارائه این شناسهها استفاده میشوند. customerId می توان از روش Users.get بدست آورد. resourceId یک شناسه Google منحصر به فرد برای یک دستگاه است و در پاسخ روش Retrieve all mobile devices یافت می شود.
برای بازیابی همه دستگاههای تلفن همراه یک حساب، از درخواست GET
زیر استفاده کنید و مجوز شرح دادهشده در درخواستهای مجوز را وارد کنید. برای خوانایی، این مثال از بازگشت خط استفاده می کند:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile?projection={BASIC|FULL}&query=query &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING} &pageToken=token for next results page &maxResults=max number of results per page
برای خواص درخواست و پاسخ، به مرجع API مراجعه کنید.
{ "kind": "directory#mobiledevices", "mobiledevices": [ { "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Sales" ], "email": [ "sales@example.com" ], "model": "Nexus 4", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "1234567890", "firstSync": "2013-05-15T17:30:04.325Z", "lastSync": "2013-06-05T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", }, { "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Liz" ], "email": [ "liz@example.com" ], "model": "Galaxy Nexus", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "9123456780", "firstSync": "2013-06-05T17:30:04.325Z", "lastSync": "2013-08-12T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", } ], "nextPageToken": "next_page_token_value" }
برای بازیابی ویژگیهای یک دستگاه تلفن همراه، از درخواست GET
زیر استفاده کنید و مجوز شرح داده شده در درخواستهای مجوز را وارد کنید. برای خوانایی، این مثال از بازگشت خط استفاده می کند:
GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId?projection={FULL|BASIC}
برای خواص درخواست و پاسخ، به مرجع API مراجعه کنید.
یک نمونه درخواست برای resourceId این است:
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/ mobile/resourceId?projection=FULL
{ "kind": "directory#mobiledevice", "resourceId": "resourceId", "deviceId": "deviceId", "name": [ "Sales3" ], "email": [ "sales@example.com" ], "model": "Nexus 4", "os": "Android 4.2.2", "type": "ANDROID", "status": "APPROVED", "hardwareId": "1234567890", "firstSync": "2010-05-15T17:30:04.325Z", "lastSync": "2013-06-05T17:30:04.325Z", "userAgent": "Google Apps Device Policy 4.14", }
برای تأیید یک دستگاه تلفن همراه، از درخواست POST
زیر استفاده کنید و مجوز شرح داده شده در درخواستهای مجاز را وارد کنید. برای خوانایی، این مثال از بازگشت خط استفاده می کند:
POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId/action
برای خواص درخواست و پاسخ، به مرجع API مراجعه کنید.
درخواست JSON زیر یک درخواست نمونه برای تأیید یک دستگاه را نشان می دهد:
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices /mobile/resourceId/action
بدن درخواست عبارت است از:
{ "action": "approve" }
یک درخواست موفق یک کد وضعیت HTTP 200 را برمی گرداند.
برای حذف یک دستگاه تلفن همراه، از درخواست DELETE
زیر استفاده کنید و مجوز شرح داده شده در درخواستهای مجاز را وارد کنید. برای خوانایی، این مثال از بازگشت خط استفاده می کند:
DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId} /devices/mobile/resourceId
برای خواص درخواست و پاسخ، به مرجع API مراجعه کنید.
یک درخواست موفق یک کد وضعیت HTTP 200 را برمی گرداند.