البيانات الوصفية للجهاز

بصفتك مورِّدًا، يمكنك ربط البيانات الوصفية، مثل رقم الهاتف أو رقم طلب الشراء مع كل جهاز. يمكنك ربط البيانات الوصفية عن طريق واجهة برمجة التطبيقات أو عن طريق تحميل ملف CSV في بوابة برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة" يوضح الجدول 1 المستخدمين الذين يمكنهم ربط البيانات الوصفية وعرضها:

الجدول 1. أذونات البيانات الوصفية

المهمة	المورّدون	العملاء
ربط البيانات الوصفية من خلال طلب البيانات من واجهة برمجة التطبيقات
ربط البيانات الوصفية من خلال تحميل ملف CSV إلى منصة برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"
عرض البيانات الوصفية للجهاز في نتائج طلبات البيانات من واجهة برمجة التطبيقات
عرض البيانات الوصفية للأجهزة في منصة برنامج "إعداد الأجهزة الجوّالة للمؤسسات دفعةً واحدة"

تعيين البيانات الوصفية

لربط البيانات الوصفية بكل جهاز، عليك إجراء طلب partners.devices.metadata. يمكنك إضافة أرقام الهواتف والطلبات لأجهزة Android باستخدام مفاتيح من الجدول 2 أدناه:

الجدول 2. مفاتيح البيانات الوصفية لأجهزة Android

البيانات	المفتاح	نوع القيمة	مثال
رقم الهاتف	phonenumber	سلسلة	‎[phone]
رقم الطلب	ordernumber	سلسلة	GOOG#123/ABC-123456

كلتا قيمتي بيانات التعريف عبارة عن سلاسل حرة الشكل، لذا يمكنك استخدام تنسيق يجعل منطقية لمؤسستك.

بالنسبة إلى أجهزة ChromeOS، يمكنك استخدام المفاتيح الواردة في الجدول 3 أدناه:

الجدول 3. مفاتيح البيانات الوصفية لأجهزة ChromeOS

البيانات	المفتاح	نوع القيمة	مثال
رقم الطلب	ordernumber	سلسلة	GOOG#123/ABC-123456

لتخصيص البيانات الوصفية أثناء إنشاء الأجهزة، يجب تضمين البيانات الوصفية عند إجراء المكالمات. claimAsync يوضح المثال أدناه إعداد رقم الهاتف ورقم الطلب للجهاز الحالي TARGET_DEVICE_ID:

Java

// Allowed metadata dictionary keys.
private static String METADATA_KEY_PHONE_NUMBER = "phonenumber";
private static String METADATA_KEY_ORDER_NUMBER = "ordernumber";

// ...
// Create the metadata record with the values.
DeviceMetadata metadata = new DeviceMetadata();
Map<String,String> entries = new HashMap<String, String>();
entries.put(METADATA_KEY_ORDER_NUMBER, "GOOG123/ABC-#123456");
entries.put(METADATA_KEY_PHONE_NUMBER, "[phone]");
metadata.setEntries(entries);

// Set the metadata values on the target device.
UpdateDeviceMetadataRequest body = new UpdateDeviceMetadataRequest();
body.setDeviceMetadata(metadata);

DeviceMetadata response = service
        .partners()
        .devices()
        .metadata(PARTNER_ID, targetDeviceId, body)
        .execute();

NET.

// Allowed metadata dictionary keys.
private static string MetadataKeyPhoneNumber = "phonenumber";
private static string MetadataKeyOrderNumber = "ordernumber";

// ...
// Create the metadata record with the values.
DeviceMetadata metadata = new DeviceMetadata
{
    Entries = new Dictionary<string, string> {
        {MetadataKeyOrderNumber, "GOOG123/ABC-#123456"},
        {MetadataKeyPhoneNumber, "[phone]"}
    }
};

// Set the metadata values on the target device.
UpdateDeviceMetadataRequest body = new UpdateDeviceMetadataRequest
{
    DeviceMetadata = metadata
};
var request = service.Partners.Devices.Metadata(body, PartnerId, targetDeviceId);
var results = request.Execute();

Python

# Allowed metadata dictionary keys.
METADATA_KEY_ENTRIES = "entries";
METADATA_KEY_PHONE_NUMBER = "phonenumber";
METADATA_KEY_ORDER_NUMBER = "ordernumber";

# ...
# Create the record with values.
new_metadata = {METADATA_KEY_ENTRIES:{ \
    METADATA_KEY_PHONE_NUMBER:'[phone]', \
    METADATA_KEY_ORDER_NUMBER:'GOOG123/ABC-#123456'}}

# Set the metadata values on the target device.
response = service.partners().devices().metadata(
    metadataOwnerId=PARTNER_ID,
    deviceId=target_device_id,
    body={'deviceMetadata':new_metadata}).execute()

تستبدل وسيطات البيانات الوصفية قيم البيانات الوصفية الحالية للمفتاح نفسه.

حذف البيانات الوصفية

يمكنك حذف البيانات الوصفية من الأجهزة. تمرير السلاسل الفارغة للبيانات الوصفية القيم التي تريد حذفها. يوضّح المثال أدناه كيفية حذف رقم الهاتف:

Java

// Create the metadata record with the values.
DeviceMetadata metadata = new DeviceMetadata();
Map<String,String> entries = new HashMap<String, String>();
entries.put(METADATA_KEY_PHONE_NUMBER, "");
metadata.setEntries(entries);

// Call partners().devices().metadata() to remove the phone metadata from the device...

NET.

// Create the metadata record with empty values.
DeviceMetadata metadata = new DeviceMetadata
{
    Entries = new Dictionary<string, string> {
        {MetadataKeyPhoneNumber, ""}
    }
};

// Call Partners.Devices.Metadata to remove the phone metadata from the device...

Python

# Create the metadata record with empty values.
metadata_to_remove = {METADATA_KEY_ENTRIES: {METADATA_KEY_PHONE_NUMBER:''}}

# Call partners().devices().metadata() to remove the phone number
# metadata from the device...