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

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

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

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

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

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

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

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

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

برای تخصیص فراداده در هنگام ایجاد دستگاه‌ها، هنگام تماس با 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, "+1 (800) 555-0100");
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, "+1 (800) 555-0100"}
    }
};

// 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:'+1 (800) 555-0100', \
    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...