فراداده دستگاه

به عنوان یک فروشنده، می‌توانید ابرداده‌ها، مانند شماره تلفن یا شماره سفارش خرید را با هر دستگاه مرتبط کنید. می‌توانید با تماس با API یا با آپلود یک فایل CSV در پورتال صفر لمسی، ابرداده‌ها را مرتبط کنید. جدول 1 نشان می دهد که چه کسی می تواند ابرداده را مرتبط و مشاهده کند:

میز 1 . مجوزهای فراداده

وظیفه	فروشندگان	مشتریان
ابرداده را با فراخوانی API مرتبط کنید
با آپلود یک فایل CSV در پورتال zero-touch، ابرداده را مرتبط کنید
مشاهده فراداده دستگاه در نتایج تماس های API
ابرداده دستگاه را در پورتال صفر لمسی مشاهده کنید

متادیتا را اختصاص دهید

برای مرتبط کردن ابرداده با هر دستگاه، با روش partners.devices.metadata تماس بگیرید. با استفاده از کلیدهای جدول 2 زیر می توانید شماره تلفن و سفارش دستگاه های اندرویدی خود را اضافه کنید:

جدول 2 . کلیدهای فراداده برای دستگاه های اندرویدی

داده ها	کلید	نوع ارزش	مثال
شماره تلفن	phonenumber	رشته	[phone]
شماره سفارش	ordernumber	رشته	GOOG#123/ABC-123456

هر دو مقدار ابرداده رشته‌هایی با فرم آزاد هستند، بنابراین می‌توانید از قالبی استفاده کنید که برای سازمان شما منطقی است.

برای دستگاه‌های ChromeOS، می‌توانید از کلیدهای جدول 3 زیر استفاده کنید:

جدول 3 . کلیدهای فراداده برای دستگاه‌های ChromeOS

داده ها	کلید	نوع ارزش	مثال
شماره سفارش	ordernumber	رشته	GOOG#123/ABC-123456

برای تخصیص فراداده در هنگام ایجاد دستگاه‌ها، هنگام تماس با claimAsync متادیتا را اضافه کنید. مثال زیر تنظیم یک شماره تلفن و شماره سفارش برای دستگاه موجود TARGET_DEVICE_ID را نشان می دهد:

جاوا

// 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();

.خالص

// 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();

پایتون

# 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()

آرگومان های ابرداده شما جایگزین مقادیر فراداده موجود برای همان کلید می شوند.

ابرداده را حذف کنید

می توانید ابرداده خود را از دستگاه ها حذف کنید. رشته های خالی را برای مقادیر فراداده ای که می خواهید حذف کنید ارسال کنید. مثال زیر نحوه حذف شماره تلفن را نشان می دهد:

جاوا

// 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...

.خالص

// 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...

پایتون

# 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...