Method: activities.list

Belirli bir müşterinin hesabı ve uygulaması (ör. Yönetici Konsolu uygulaması veya Google Drive uygulaması) için etkinlik listesini alır. Daha fazla bilgi için yönetici ve Google Drive etkinlik raporlarıyla ilgili kılavuzlara bakın. Etkinlik raporunun parametreleri hakkında daha fazla bilgi için etkinlik parametreleri referans kılavuzlarına bakın.

HTTP isteği

GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

Yol parametreleri

Parametreler
userKey or all

string

Verilerin filtrelenmesi gereken profil kimliğini veya kullanıcı e-postasını temsil eder. Tüm bilgiler için all, kullanıcının benzersiz Google Workspace profil kimliği veya birincil e-posta adresi için userKey olabilir. Silinmiş bir kullanıcı olmamalıdır. Silinen bir kullanıcı için Directory API'de showDeleted=true ile users.list işlevini çağırın, ardından döndürülen ID değerini userKey olarak kullanın.
applicationName

enum (ApplicationName)

Etkinliklerin alınacağı uygulamanın adı.

Sorgu parametreleri

Parametreler
actorIpAddress

string

Etkinliğin gerçekleştirildiği ana makinenin İnternet Protokolü (IP) adresi. Bu, etkinliği raporlanan kullanıcının IP adresini kullanarak rapor özetini filtrelemenin ek bir yoludur. Bu IP adresi, kullanıcının fiziksel konumunu yansıtmayabilir. Örneğin, IP adresi kullanıcının proxy sunucusunun adresi veya sanal özel ağ (VPN) adresi olabilir. Bu parametre hem IPv4 hem de IPv6 adres sürümlerini destekler.
customerId

string

Verilerin alınacağı müşterinin benzersiz kimliği.
endTime

string

Raporda gösterilen zaman aralığının sonunu ayarlar. Tarih, RFC 3339 biçimindedir (ör. 2010-10-28T10:26:35.000Z). Varsayılan değer, API isteğinin yaklaşık süresidir. API raporunda üç temel zaman kavramı bulunur:

  • API'nin rapor isteğinde bulunduğu tarih: API'nin raporu oluşturup aldığı zaman.
  • Raporun başlangıç zamanı: Raporda gösterilen zaman aralığının başlangıcı. İstek yapıldığında startTime, endTime (belirtilmişse) ve geçerli saatten önce olmalıdır. Aksi takdirde API hata döndürür.
  • Raporun bitiş zamanı: Raporda gösterilen zaman aralığının sonu. Örneğin, bir raporda özetlenen etkinliklerin zaman aralığı Nisan ayında başlayıp Mayıs ayında sona erebilir. Raporun kendisi Ağustos ayında istenebilir.
endTime belirtilmezse rapor, startTime tarihinden itibaren geçerli zamana kadar olan tüm etkinlikleri veya startTime 180 günden daha eski bir tarihse son 180 günü döndürür.

Gmail istekleri için startTime ve endTime sağlanmalı ve aralarındaki fark 30 günden fazla olmamalıdır.
eventName

string

API tarafından sorgulanan etkinliğin adı. Her eventName, API'nin etkinlik türleri halinde düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilgilidir. Örneğin, Yönetici Konsolu uygulamasının raporlarındaki Google Takvim etkinlikleri. Takvim Ayarları type yapısında, API tarafından bildirilen tüm Takvim eventName etkinlikleri bulunur. Bir yönetici Takvim ayarını değiştirdiğinde API, bu etkinliği Takvim ayarları type ve eventName parametrelerinde bildirir. eventName sorgu dizeleri ve parametreleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesine bakın.
filters

string

filters sorgu dizesi, ilişkisel operatörlerle değiştirilen etkinlik parametrelerinden oluşan, virgülle ayrılmış bir listedir. Etkinlik parametreleri şu biçimdedir: {parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...

Bu etkinlik parametreleri belirli bir eventName ile ilişkilendirilir. İsteğin parametresi eventName'ya ait değilse boş bir rapor döndürülür. Her uygulama için kullanılabilen eventName alanlar ve bunlarla ilişkili parametreler hakkında daha fazla bilgi edinmek için ApplicationName tablosuna gidin, ardından istediğiniz uygulamanın Ekler bölümündeki Etkinlik Etkinlikleri sayfasına tıklayın.

Aşağıdaki Drive etkinliği örneklerinde, döndürülen liste, edit parametre değerinin ilişkisel operatör tarafından tanımlanan koşullarla eşleştiği tüm doc_id etkinliklerinden oluşur. İlk örnekte, istek doc_id değeri 12345 olan tüm düzenlenmiş dokümanları döndürür. İkinci örnekte rapor, doc_id değerinin 98765 değerine eşit olmadığı tüm düzenlenmiş dokümanları döndürür. <> operatörü, isteğin sorgu dizesinde URL biçiminde kodlanmıştır (%3C%3E):

GET...&eventName=edit&filters=doc_id==12345
GET...&eventName=edit&filters=doc_id%3C%3E98765

filters sorgusu şu ilişkisel operatörleri destekler:

  • ==: "eşittir".
  • <>: "Eşit değil" URL kodlamalı olmalıdır (%3C%3E).
  • <: "daha az". URL kodlamalı olmalıdır (%3C).
  • <=: "küçük veya eşit" URL kodlamalı olmalıdır (%3C=).
  • >: "Büyüktür". URL kodlamalı olmalıdır (%3E).
  • >=: "büyük veya eşittir". URL kodlamalı olmalıdır (%3E=).

Not: API, aynı parametrenin birden fazla değerini kabul etmez. Bir parametre API isteğinde birden fazla kez sağlanırsa API yalnızca bu parametrenin son değerini kabul eder. Ayrıca, API isteğinde geçersiz bir parametre sağlanırsa API bu parametreyi yoksayar ve kalan geçerli parametrelere karşılık gelen yanıtı döndürür. Parametre istenmezse tüm parametreler döndürülür.
maxResults

integer

Her yanıt sayfasında kaç etkinlik kaydının gösterileceğini belirler. Örneğin, istek maxResults=1 olarak ayarlanmışsa ve raporda iki etkinlik varsa raporda iki sayfa bulunur. Yanıtın nextPageToken özelliğinde ikinci sayfanın jetonu var. İstekteki maxResults sorgu dizesi isteğe bağlıdır. Varsayılan değer 1.000'dir.
orgUnitID

string

Rapor oluşturulacak kuruluş biriminin kimliği. Etkinlik kayıtları yalnızca belirtilen kuruluş birimine ait kullanıcılar için gösterilir.

pageToken

string

Sonraki sayfayı belirtmek için kullanılan jeton. Birden fazla sayfaya sahip bir raporda yanıtta nextPageToken özelliği bulunur. Raporun bir sonraki sayfasını almak için gönderdiğiniz takip eden istekte, nextPageToken değerini pageToken sorgu dizesine girin.
startTime

string

Raporda gösterilen zaman aralığının başlangıcını ayarlar. Tarih, RFC 3339 biçimindedir (ör. 2010-10-28T10:26:35.000Z). Rapor, startTime ile endTime arasındaki tüm etkinlikleri döndürür. İstek yapıldığında startTime, endTime (belirtilmişse) ve geçerli saatten önce olmalıdır. Aksi takdirde API hata döndürür.

Gmail istekleri için startTime ve endTime sağlanmalı ve aralarındaki fark 30 günden fazla olmamalıdır.
groupIdFilter

string

Kullanıcı etkinliklerinin filtrelendiği virgülle ayrılmış grup kimlikleri (karmaşıklaştırılmış). Örneğin, yanıt yalnızca burada belirtilen grup kimliklerinden en az birinin parçası olan kullanıcıların etkinliklerini içerir. Biçim: "id:abc123,id:xyz456"

İstek içeriği

İstek metni boş olmalıdır.

Yanıt gövdesi

Bir etkinlik koleksiyonu için JSON şablonu.

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (Activity)
    }
  ],
  "nextPageToken": string
}
Alanlar
kind

string

API kaynağının türü. Etkinlik raporu için değer reports#activities şeklindedir.
etag

string

Kaynağın ETag'i.
items[]

object (Activity)

Yanıtın her bir etkinlik kaydı.
nextPageToken

string

Raporun sonraki sayfasını almak için kullanılan jeton. nextPageToken değeri, isteğin pageToken sorgu dizesinde kullanılır.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

  • https://www.googleapis.com/auth/admin.reports.audit.readonly

Daha fazla bilgi için Yetkilendirme kılavuzu'na bakın.

ApplicationName

Sıralamalar
access_transparency

Google Workspace Erişim Şeffaflığı etkinlik raporları, farklı türlerdeki Erişim Şeffaflığı etkinlik olayları hakkında bilgi döndürür.
admin

Yönetici Konsolu uygulamasının etkinlik raporları, farklı türlerdeki yönetici etkinliği etkinlikleri hakkında hesap bilgileri döndürür.
calendar

Google Takvim uygulamasının etkinlik raporları, çeşitli Takvim etkinliği etkinlikleri hakkında bilgi döndürür.
chat Chat etkinliği raporları, çeşitli Chat etkinliği etkinlikleri hakkında bilgi döndürür.
drive

Google Drive uygulamasının etkinlik raporları, çeşitli Google Drive etkinlikleri hakkında bilgi döndürür. Drive etkinlik raporu yalnızca Google Workspace Business ve Enterprise müşterileri tarafından kullanılabilir.
gcp Google Cloud Platform uygulamasının etkinlik raporları, çeşitli GCP etkinlikleri hakkında bilgi döndürür.
gmail Gmail uygulamasının etkinlik raporları, çeşitli Gmail etkinlikleri hakkında bilgi döndürür.
gplus Google+ uygulamasının etkinlik raporları, çeşitli Google+ etkinlikleri hakkında bilgi döndürür.
groups

Google Gruplar uygulamasının etkinlik raporları, çeşitli Gruplar etkinlikleri hakkında bilgi döndürür.
groups_enterprise

Enterprise Groups etkinlik raporları, çeşitli Enterprise Groups etkinlikleri hakkında bilgi döndürür.
jamboard Jamboard etkinlik raporları, çeşitli Jamboard etkinlikleri hakkında bilgi döndürür.
login

Giriş uygulaması etkinlik raporları, farklı türlerdeki giriş etkinliği olayları hakkında hesap bilgileri döndürür.
meet Meet denetleme etkinliği raporu, farklı türlerdeki Meet denetleme etkinliği etkinlikleri hakkında bilgi döndürür.
mobile Cihaz denetimi etkinlik raporu, farklı türlerdeki cihaz denetimi etkinlikleri hakkında bilgi döndürür.
rules

Kurallar etkinliği raporu, farklı kurallar etkinliği etkinlikleri türleri hakkında bilgi döndürür.
saml

SAML etkinliği raporu, farklı türlerdeki SAML etkinliği etkinlikleri hakkında bilgi döndürür.
token

Token uygulamasının etkinlik raporları, farklı türlerdeki Token etkinlikleri hakkında hesap bilgileri döndürür.
user_accounts

Kullanıcı Hesapları uygulamasının etkinlik raporları, farklı türlerdeki Kullanıcı Hesapları etkinlikleri hakkında hesap bilgileri döndürür.
context_aware_access

Bağlama duyarlı erişim etkinliği raporları, kullanıcıların bağlama duyarlı erişim kuralları nedeniyle reddedilen erişim etkinlikleri hakkında bilgi döndürür.
chrome

Chrome etkinlik raporları, Chrome Tarayıcı ve Chrome OS etkinlikleri hakkında bilgi döndürür.
data_studio Data Studio etkinlik raporları, çeşitli Data Studio etkinlikleri hakkında bilgi döndürür.
keep Keep uygulamasının etkinlik raporları, çeşitli Google Keep etkinlikleri hakkında bilgi döndürür. Keep etkinlik raporu yalnızca Google Workspace Business ve Enterprise müşterileri tarafından kullanılabilir.
vault Apps Kasası etkinlik raporları, çeşitli Apps Kasası etkinlikleriyle ilgili bilgileri döndürür.
gemini_in_workspace_apps Workspace için Gemini etkinlik raporları, kullanıcıların bir Workspace uygulamasında gerçekleştirdiği çeşitli Gemini etkinlikleri hakkında bilgi döndürür.
classroom Classroom etkinlik raporları, farklı türlerdeki Classroom etkinlikleri hakkında bilgi döndürür.

Etkinlik

Etkinlik kaynağı için JSON şablonu.

JSON gösterimi 
{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ],
      "resourceIds": [
        string
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string,
    "applicationInfo": {
      "oauthClientId": string,
      "applicationName": string,
      "impersonation": boolean
    }
  },
  "networkInfo": {
    object (NetworkInfo)
  },
  "resourceDetails": [
    {
      object (ResourceDetails)
    }
  ]
}
Alanlar
kind

string

API kaynağının türü. Etkinlik raporu için değer audit#activity şeklindedir.
etag

string

Girişin ETag'i.
ownerDomain

string

Bu, raporun etkinliğinden etkilenen alan adıdır. Örneğin, Yönetici Konsolu'nun veya Drive uygulamasının doküman sahibinin alan adı.
ipAddress

string

İşlemi yapan kullanıcının IP adresi. Bu, Google Workspace'e giriş yaparken kullanıcının İnternet Protokolü (IP) adresidir. Kullanıcının fiziksel konumunu yansıtmayabilir. Örneğin, IP adresi kullanıcının proxy sunucusunun adresi veya sanal özel ağ (VPN) adresi olabilir. API, IPv4 ve IPv6'yı destekler.
events[]

object

Rapordaki etkinlik etkinlikleri.
events[].type

string

Etkinlik türü. Bir yöneticinin değiştirdiği Google Workspace hizmeti veya özelliği, eventName özelliği kullanılarak bir etkinliği tanımlayan type özelliğinde tanımlanır. API'nin type kategorilerinin tam listesi için yukarıdaki applicationName bölümünde çeşitli uygulamalara yönelik etkinlik adlarının listesine bakın.
events[].name

string

Etkinliğin adı. Bu, API tarafından bildirilen etkinliğin adıdır. Her eventName, API'nin etkinlik türleri halinde düzenlediği belirli bir Google Workspace hizmeti veya özelliğiyle ilgilidir.
Genel olarak eventName istek parametreleri için:

  • eventName verilmezse raporda eventName ile ilgili olası tüm örnekler döndürülür.
  • Bir eventName istediğinizde API'nin yanıtı, bu eventName içeren tüm etkinlikleri döndürür.

eventName özellikleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesini inceleyin.
events[].parameters[]

object

Çeşitli uygulamalar için parametre değeri çiftleri. eventName parametreleri hakkında daha fazla bilgi için yukarıdaki applicationName bölümünde çeşitli uygulamalara ait etkinlik adlarının listesine bakın.
events[].parameters[].messageValue

object

Bu parametreyle ilişkili iç içe yerleştirilmiş parametre değeri çiftleri. Bir parametrenin karmaşık değer türü, parametre değerlerinin listesi olarak döndürülür. Örneğin, adres parametresinin değeri [{parameter: [{name: city, value: abc}]}] olabilir.
events[].parameters[].messageValue.parameter[]

object (NestedParameter)

Parametre değerleri
events[].parameters[].name

string

Parametrenin adı.
events[].parameters[].value

string

Parametrenin dize değeri.
events[].parameters[].multiValue[]

string

Parametrenin dize değerleri.
events[].parameters[].intValue

string (int64 format)

Parametrenin tam sayı değeri.
events[].parameters[].multiIntValue[]

string (int64 format)

Parametrenin tam sayı değerleri.
events[].parameters[].boolValue

boolean

Parametrenin Boole değeri.
events[].parameters[].multiMessageValue[]

object

activities.list of messageValue objects.
events[].parameters[].multiMessageValue[].parameter[]

object (NestedParameter)

Parametre değerleri
events[].resourceIds[]

string

Etkinlikle ilişkili kaynak kimlikleri.
id

object

Her etkinlik kaydı için benzersiz tanımlayıcı.
id.time

string

Etkinliğin gerçekleştiği zaman. Bu değer, saniye cinsinden UNIX sıfır zamanı biçimindedir.
id.uniqueQualifier

string (int64 format)

Birden fazla etkinlik aynı zamana sahipse benzersiz niteleyici.
id.applicationName

string

Etkinliğin ait olduğu uygulamanın adı. Olası değerler için yukarıdaki applicationName bölümünde yer alan uygulama listesine bakın.
id.customerId

string

Google Workspace hesabının benzersiz tanımlayıcısı.
actor

object

İşlemi yapan kullanıcı.
actor.profileId

string

Aktörün benzersiz Google Workspace profil kimliği. Aktör bir Google Workspace kullanıcısı değilse bu değer mevcut olmayabilir veya yer tutucu kimlik olarak kullanılan 105250506097979753968 sayısı olabilir.
actor.email

string

İşlemi gerçekleştiren kullanıcının birincil e-posta adresi. Aktörle ilişkili bir e-posta adresi yoksa bu alan bulunmayabilir.
actor.callerType

string

İşlemi gerçekleştiren kullanıcının türü.
actor.key

string

Yalnızca callerType, KEY olduğunda gösterilir. OAuth 2LO API istekleri için istekte bulunanın consumer_key veya robot hesaplarının tanımlayıcısı olabilir.
actor.applicationInfo

object

Etkinliğin aktörü olan uygulamanın ayrıntıları.
actor.applicationInfo.oauthClientId

string

İşlemi gerçekleştirmek için kullanılan üçüncü taraf uygulamasının OAuth istemci kimliği.
actor.applicationInfo.applicationName

string

İşlemi gerçekleştirmek için kullanılan uygulamanın adı.
actor.applicationInfo.impersonation

boolean

Uygulamanın bir kullanıcının kimliğine bürünüp bürünmediği.
networkInfo

object (NetworkInfo)

İşlemi yapan kullanıcının ağ bilgileri.
resourceDetails[]

object (ResourceDetails)

İşlemin gerçekleştirildiği kaynağın ayrıntıları.

NetworkInfo

İşlemi yapan kullanıcının ağ bilgileri.

JSON gösterimi 
{
  "ipAsn": [
    integer
  ],
  "regionCode": string,
  "subdivisionCode": string
}
Alanlar
ipAsn[]

integer

İşlemi yapan kullanıcının IP adresi.
regionCode

string

İşlemi yapan kullanıcının ISO 3166-1 alfa-2 bölge kodu.
subdivisionCode

string

İşlemi yapan kullanıcının bulunduğu ülkeler için ISO 3166-2 bölge kodu (eyaletler ve iller).

ResourceDetails

İşlemin gerçekleştirildiği kaynağın ayrıntıları.

JSON gösterimi 
{
  "id": string,
  "title": string,
  "type": string,
  "appliedLabels": [
    {
      object (AppliedLabel)
    }
  ],
  "relation": string
}
Alanlar
id

string

Kaynağın tanımlayıcısı.
title

string

Kaynağın başlığı. Örneğin, bir Drive belgesi söz konusu olduğunda bu, belgenin başlığı olur. E-posta söz konusu olduğunda bu, konu olur.
type

string

Kaynağın türü (belge, e-posta, sohbet mesajı)
appliedLabels[]

object (AppliedLabel)

activities.list of labels applied on the resource
relation

string

Kaynağın etkinliklerle ilişkisini tanımlar.

AppliedLabel

Kaynağa uygulanan etiketin ayrıntıları.

JSON gösterimi 
{
  "id": string,
  "title": string,
  "fieldValues": [
    {
      object (FieldValue)
    }
  ],
  "reason": {
    object (Reason)
  }
}
Alanlar
id

string

Etiketin tanımlayıcısı: Yalnızca etiket kimliği, tam OnePlatform kaynak adı değil.
title

string

Etiketin başlığı
fieldValues[]

object (FieldValue)

Etiketin parçası olan ve kullanıcı tarafından ayarlanan alanların listesi. Etikette, kullanıcı tarafından ayarlanmamış bir alan varsa bu listede yer almaz.
reason

object (Reason)

Etiketin kaynağa uygulanma nedeni.

FieldValue

Kullanıcı tarafından belirli etiket için ayarlanan alan değerinin ayrıntıları.

JSON gösterimi 
{
  "id": string,
  "displayName": string,
  "type": string,
  "reason": {
    object (Reason)
  },

  // Union field value can be only one of the following:
  "unsetValue": boolean,
  "longTextValue": string,
  "textValue": string,
  "textListValue": {
    object (TextListValue)
  },
  "selectionValue": {
    object (SelectionValue)
  },
  "selectionListValue": {
    object (SelectionListValue)
  },
  "integerValue": string,
  "userValue": {
    object (UserValue)
  },
  "userListValue": {
    object (UserListValue)
  },
  "dateValue": {
    object (Date)
  }
  // End of list of possible types for union field value.
}
Alanlar
id

string

Alan tanımlayıcısı
displayName

string

Alanın görünen adı
type

string

Alanın türü
reason

object (Reason)

Alanının etikete uygulanma nedeni.
Birleştirme alanı value. value alanında depolanan değerler yalnızca aşağıdakilerden biri olabilir:
unsetValue

boolean

Alan ayarlanmamışsa bu değer doğru olur.
longTextValue

string

Uzun bir metin değeri ayarlama.
textValue

string

Metin değeri ayarlama.
textListValue

object (TextListValue)

Metin listesi değeri ayarlama.
selectionValue

object (SelectionValue)

Açılır menüden tek bir değer seçerek seçim değeri ayarlama.
selectionListValue

object (SelectionListValue)

Açılır listeden birden fazla değer seçerek seçim listesi değeri ayarlama.
integerValue

string (int64 format)

Tam sayı değeri ayarlama.
userValue

object (UserValue)

Tek bir kullanıcıyı seçerek kullanıcı değeri ayarlama
userListValue

object (UserListValue)

Birden fazla kullanıcı seçerek kullanıcı listesi değeri ayarlama.
dateValue

object (Date)

Tarih değeri ayarlama.

TextListValue

Metin listesi değeri ayarlama.

JSON gösterimi 
{
  "values": [
    string
  ]
}
Alanlar
values[]

string

activities.list of text values.

SelectionValue

Açılır menüden tek bir değer seçerek seçim değeri ayarlama.

JSON gösterimi 
{
  "id": string,
  "displayName": string,
  "badged": boolean
}
Alanlar
id

string

Seçimin tanımlayıcısı.
displayName

string

Seçimin görünen adı.
badged

boolean

Seçimin rozetli olup olmadığı.

SelectionListValue

Açılır listeden birden fazla değer seçerek seçim listesi değeri ayarlama.

JSON gösterimi 
{
  "values": [
    {
      object (SelectionValue)
    }
  ]
}
Alanlar
values[]

object (SelectionValue)

activities.list of selections.

UserValue

Tek bir kullanıcıyı seçerek kullanıcı değeri ayarlama

JSON gösterimi 
{
  "email": string
}
Alanlar
email

string

Kullanıcının e-posta adresi.

UserListValue

Birden fazla kullanıcı seçerek kullanıcı listesi değeri ayarlama.

JSON gösterimi 
{
  "values": [
    {
      object (UserValue)
    }
  ]
}
Alanlar
values[]

object (UserValue)

activities.list of users.

Tarih

Doğum günü gibi tam veya kısmi bir takvim tarihini gösterir. Günün saati ve saat dilimi başka bir yerde belirtilmiştir veya önemsizdir. Tarih, Gregoryen Takvimi'ne göre belirlenir. Bu, aşağıdakilerden birini temsil edebilir:

  • Yıl, ay ve gün değerleri sıfır olmayan tam bir tarih.
  • Ay ve gün, sıfır yılıyla (örneğin, yıl dönümü).
  • Tek başına bir yıl, sıfır ay ve sıfır gün.
  • Bir yıl ve ay, sıfır günle (örneğin, kredi kartının son kullanma tarihi).

İlgili türler:

JSON gösterimi 
{
  "year": integer,
  "month": integer,
  "day": integer
}
Alanlar
year

integer

Tarihin yılı. 1 ile 9999 arasında olmalı veya yıl içermeyen bir tarih belirtmek için 0 olmalıdır.
month

integer

Yılın ayı. 1 ile 12 arasında olmalıdır veya ay ve gün içermeyen bir yıl belirtmek için 0 olmalıdır.
day

integer

Ayın günü. 1 ile 31 arasında olmalı ve yıl ile ay için geçerli olmalıdır. Yalnızca bir yılı veya günün önemli olmadığı bir yıl ve ayı belirtmek için 0 olmalıdır.

Neden

Etiketin/alanın uygulanma nedeni.

JSON gösterimi 
{
  "reasonType": string
}
Alanlar
reasonType

string

Nedeni türü.