デバイス メタデータ

販売パートナー様は、メタデータ（電話番号や 注文書番号、デバイス名を記載します。メタデータを関連付けるには、 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

デバイスの作成時にメタデータを割り当てるには、呼び出し時にメタデータを含めます。 claimAsync。以下の例は、指標スコープ内で 既存のデバイス TARGET_DEVICE_ID の電話番号と注文番号:

Java.NETPython

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

メタデータ引数は、同じキーの既存のメタデータ値を置き換えます。

メタデータの削除

デバイスからメタデータを削除できます。メタデータに空の文字列を渡す 選択します。以下の例は、電話を削除する方法を示しています。 number:

Java.NETPython

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