Cihaz meta verileri

Bayi olarak her cihazla telefon numarası veya satın alma siparişi numarası gibi meta verileri ilişkilendirebilirsiniz. API'yi çağırarak veya el değmeden kayıt portalına bir CSV dosyası yükleyerek meta verileri ilişkilendirebilirsiniz. Tablo 1, meta verileri kimlerin ilişkilendirebileceğini ve görüntüleyebileceğini gösterir:

Tablo 1. Meta veri izinleri

Görev	Bayiler	Müşteriler
API'yi çağırarak meta verileri ilişkilendirme
El değmeden kayıt portalına CSV dosyası yükleyerek meta verileri ilişkilendirin
API çağrılarının sonuçlarında cihaz meta verilerini görüntüleme
El değmeden kayıt portalında cihaz meta verilerini görüntüleyin

Meta veri ata

Meta verileri her bir cihazla ilişkilendirmek için partners.devices.metadata yöntemini çağırın. Aşağıdaki 2. tabloda yer alan anahtarları kullanarak Android cihazlarınız için telefon ve sipariş numaraları ekleyebilirsiniz:

Tablo 2. Android cihazlar için meta veri anahtarları

Veriler	Anahtar	Değer türü	Örnek
Telefon numarası	phonenumber	Dize	[phone]
Sipariş numarası	ordernumber	Dize	GOOG#123/ABC-123456

Her iki meta veri değeri de serbest biçimli dize olduğundan kuruluşunuz için anlamlı olan bir biçim kullanabilirsiniz.

ChromeOS cihazlar için aşağıdaki 3. tabloda yer alan anahtarları kullanabilirsiniz:

Tablo 3. ChromeOS cihazlar için meta veri anahtarları

Veriler	Anahtar	Değer türü	Örnek
Sipariş numarası	ordernumber	Dize	GOOG#123/ABC-123456

Cihazları oluştururken meta veri atamak için claimAsync çağrısı yaparken meta verileri ekleyin. Aşağıdaki örnekte, mevcut TARGET_DEVICE_ID cihazı için bir telefon numarası ve sipariş numarasının ayarlanması gösterilmektedir:

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

Meta veri bağımsız değişkenleriniz, aynı anahtarın mevcut meta veri değerlerinin yerini alır.

Meta veriyi sil

Meta verilerinizi cihazlardan silebilirsiniz. Silmek istediğiniz meta veri değerleri için boş dizeler iletin. Aşağıdaki örnekte, telefon numarasının nasıl silineceği gösterilmektedir:

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