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 CSV dosyası yükleyerek meta verileri ilişkilendirebilirsiniz. Tablo 1'de meta verileri kimlerin ilişkilendirebileceği ve görüntüleyebileceği gösterilmektedir:

Tablo 1. Meta veri izinleri

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

Meta veri atama

Meta verileri her cihazla ilişkilendirmek için partners.devices.metadata yöntemini çağırın. Aşağıdaki 2. tablodaki 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 +1 (800) 555-0100
Sipariş numarası ordernumber Dize GOOG#123/ABC-123456

Her iki meta veri değeri de serbest biçimli dizelerdir. Bu nedenle, kuruluşunuz için anlamlı bir biçim kullanabilirsiniz.

ChromeOS cihazlarda aşağıdaki 3. tablodaki tuşları 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
Öğe Kimliği annotatedassetid Dize CORP-001234
Konum annotatedlocation Dize New York
Atanmış Kullanıcı annotateduser Dize John Doe

Cihaz oluştururken meta veri atamak için claimAsync çağrılırken meta verileri ekleyin. Aşağıdaki örnekte, mevcut cihaz için telefon numarası ve sipariş numarası ayarlanması gösterilmektedir 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()

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

Meta verileri silme

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