ডিভাইস মেটাডেটা

একজন রিসেলার হিসেবে আপনি প্রতিটি ডিভাইসের সাথে মেটাডেটা, যেমন টেলিফোন নম্বর বা পারচেজ অর্ডার নম্বর, যুক্ত করতে পারেন। আপনি এপিআই (API) কল করে অথবা জিরো-টাচ পোর্টালে একটি সিএসভি (CSV) ফাইল আপলোড করে মেটাডেটা যুক্ত করতে পারেন। সারণি ১-এ দেখানো হয়েছে কারা মেটাডেটা যুক্ত করতে এবং দেখতে পারবেন:

সারণি ১। মেটাডেটা অনুমতি

কাজ	পুনর্বিক্রেতারা	গ্রাহকরা
এপিআই কল করে মেটাডেটা সংযুক্ত করুন
জিরো-টাচ পোর্টালে একটি CSV ফাইল আপলোড করে মেটাডেটা সংযুক্ত করুন।
এপিআই কলের ফলাফলে ডিভাইসের মেটাডেটা দেখুন
জিরো-টাচ পোর্টালে ডিভাইসের মেটাডেটা দেখুন

মেটাডেটা নির্ধারণ করুন

প্রতিটি ডিভাইসের সাথে মেটাডেটা যুক্ত করতে, partners.devices.metadata মেথডটি কল করুন। নিচের টেবিল ২ থেকে কীগুলো ব্যবহার করে আপনি আপনার অ্যান্ড্রয়েড ডিভাইসগুলোর জন্য টেলিফোন এবং অর্ডার নম্বর যোগ করতে পারেন:

সারণি ২। অ্যান্ড্রয়েড ডিভাইসগুলির মেটাডেটা কী

ডেটা	চাবি	মান প্রকার	উদাহরণ
টেলিফোন নম্বর	phonenumber	স্ট্রিং	[phone]
অর্ডার নম্বর	ordernumber	স্ট্রিং	GOOG#123/ABC-123456

উভয় মেটাডেটা মানই মুক্ত-ফর্মের স্ট্রিং, তাই আপনি আপনার প্রতিষ্ঠানের জন্য উপযুক্ত একটি ফরম্যাট ব্যবহার করতে পারেন।

ChromeOS ডিভাইসগুলোর জন্য, আপনি নিচের সারণি ৩ থেকে কী-গুলো ব্যবহার করতে পারেন:

সারণি ৩। ক্রোমওএস ডিভাইসগুলির মেটাডেটা কী

ডেটা	চাবি	মান প্রকার	উদাহরণ
অর্ডার নম্বর	ordernumber	স্ট্রিং	GOOG#123/ABC-123456
সম্পদ আইডি	annotatedassetid	স্ট্রিং	কর্প-০০১২৩৪
অবস্থান	annotatedlocation	স্ট্রিং	নিউ ইয়র্ক
নির্ধারিত ব্যবহারকারী	annotateduser	স্ট্রিং	জন ডো

ডিভাইস তৈরি করার সময় মেটাডেটা নির্ধারণ করতে, 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();

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

পাইথন

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

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

পাইথন

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