डिवाइस का मेटाडेटा

रीसेलर के तौर पर, आपके पास मेटाडेटा जोड़ने की सुविधा होती है. जैसे, टेलीफ़ोन नंबर या हर डिवाइस के साथ परचेज़ ऑर्डर (पीओ) नंबर. आप कॉल करके मेटाडेटा जोड़ सकते हैं एपीआई को चुनकर या CSV फ़ाइल अपलोड करके 'पहले से तैयार डिवाइस' सुविधा वाले पोर्टल में उपलब्ध है. पहली टेबल में दिखाया गया है कि मेटाडेटा को कौन देख सकता है और कौन असोसिएट कर सकता है:

टेबल 1. मेटाडेटा की अनुमतियां

टास्क रीसेलर ग्राहक
एपीआई को कॉल करके मेटाडेटा जोड़ें
पहले से तैयार पोर्टल पर CSV फ़ाइल अपलोड करके मेटाडेटा जोड़ना
एपीआई कॉल के नतीजों में डिवाइस का मेटाडेटा देखना
'पहले से तैयार डिवाइस' सुविधा वाले पोर्टल में डिवाइस का मेटाडेटा देखें

मेटाडेटा असाइन करना

हर डिवाइस से मेटाडेटा जोड़ने के लिए, partners.devices.metadata तरीका. आप ये चीज़ें जोड़ सकते हैं टेबल 2 में दी गई कुंजियों का इस्तेमाल करके, अपने Android डिवाइसों के लिए टेलीफ़ोन और ऑर्डर नंबर नीचे दिया गया है:

टेबल 2. Android डिवाइसों के लिए मेटाडेटा कुंजियां

Data सुरक्षा कुंजी वैल्यू टाइप उदाहरण
टेलीफ़ोन नंबर phonenumber स्ट्रिंग +1 (800) 555-0100
ऑर्डर नंबर ordernumber स्ट्रिंग GOOGLE#123/ABC-123456

दोनों मेटाडेटा मान फ़्री-फ़ॉर्म स्ट्रिंग हैं, इसलिए आप ऐसे फ़ॉर्मैट का इस्तेमाल कर सकते हैं जो कोई बात नहीं.

ChromeOS डिवाइसों के लिए, नीचे दी गई टेबल 3 में दी गई कुंजियों का इस्तेमाल किया जा सकता है:

टेबल 3. ChromeOS डिवाइसों के लिए मेटाडेटा कुंजियां

Data सुरक्षा कुंजी वैल्यू टाइप उदाहरण
ऑर्डर नंबर 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, "+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();

.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, "+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();

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:'+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()

आपके मेटाडेटा आर्ग्युमेंट, एक ही कुंजी के लिए मौजूदा मेटाडेटा वैल्यू को बदल देते हैं.

मेटाडेटा मिटाएं

आपके पास डिवाइसों से अपना मेटाडेटा मिटाने का विकल्प होता है. मेटाडेटा के लिए खाली स्ट्रिंग पास करें जिन वैल्यू को मिटाना है. नीचे दिए गए उदाहरण में टेलीफ़ोन को मिटाने का तरीका बताया गया है संख्या:

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