המטא-נתונים של המכשיר

בתור משווקים, אתם יכולים לשייך מטא-נתונים לכל מכשיר, כמו מספר טלפון או מספר הזמנת רכש. אפשר לשייך מטא-נתונים באמצעות קריאה ל-API או העלאת קובץ CSV בפורטל ההרשמה דרך הארגון. בטבלה 1 מפורטות הרשאות השיוך והצפייה במטא-נתונים:

טבלה 1. הרשאות למטא-נתונים

משימה	מפיצים	לקוחות
שיוך מטא-נתונים באמצעות קריאה ל-API
שיוך מטא-נתונים באמצעות העלאת קובץ CSV לפורטל ההרשמה דרך הארגון
צפייה במטא נתונים של המכשיר בתוצאות של קריאות ל-API
הצגת מטא נתונים של מכשירים בפורטל ללא מגע

הקצאת מטא-נתונים

כדי לשייך מטא-נתונים לכל מכשיר, צריך להפעיל את השיטה partners.devices.metadata. אתם יכולים להוסיף מספרי טלפון ומספרי הזמנות למכשירי Android באמצעות המקשים שמפורטים בטבלה 2 בהמשך:

טבלה 2. מפתחות מטא-נתונים למכשירי Android

נתונים	מפתח	סוג ערך	דוגמה
מספר טלפון	phonenumber	מחרוזת	‎[phone]
מספר ההזמנה	ordernumber	מחרוזת	GOOG#123/ABC-123456

שני ערכי המטא-נתונים הם מחרוזות חופשיות, כך שאתם יכולים להשתמש בפורמט שמתאים לארגון שלכם.

במכשירי ChromeOS, אפשר להשתמש במקשים שמופיעים בטבלה 3 למטה:

טבלה 3. מפתחות מטא נתונים למכשירי ChromeOS

נתונים	מפתח	סוג ערך	דוגמה
מספר ההזמנה	ordernumber	מחרוזת	GOOG#123/ABC-123456
מזהה נכס	annotatedassetid	מחרוזת	CORP-001234
מיקום	annotatedlocation	מחרוזת	ניו יורק
משתמש מוקצה	annotateduser	מחרוזת	John Doe

כדי להקצות מטא-נתונים כשיוצרים מכשירים, צריך לכלול את המטא-נתונים כשקוראים ל-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...