Analytics'teki verileri dışa aktarma

Apigee Edge belgelerini görüntülüyorsunuz.
Apigee X belgelerine gidin.
bilgi

Atanan servis temsilcileri için izinleri ayarlama

Yukarıda açıklanan değişikliklere hazırlanmak için atanmış hizmet temsilcilerinin izinlerini ayarlamak üzere aşağıdaki adımları uygulayın.

  1. Aşağıdaki komutu girerek Google Cloud hizmet aracınızın adını bulun:
    curl -X GET \
      "https://api.enterprise.apigee.com/v1/organizations/ORG" \
      -u email:password \
      | jq -r '.properties.property[] | select(.name=="serviceAgent.analytics") | .value'

    ORG kuruluşunuzdur. Bu işlev, hizmet aracısının adını ve değerini aşağıdaki gibi döndürür:

    "property" : [
      {
       "name" : "serviceAgent.analytics",
       "value" : "service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com"
       },
  2. Google Cloud Console'da IAM kontrol panelini açın.
  3. Google Cloud projenizi seçin.
  4. IAM bölmesinin üst kısmındaki Ekle'yi tıklayın.
  5. Yeni ana hesaplar alanına, 1. adımda döndürülen hizmet aracısını value girin. Örneğin, 1. adımda gösterilen value, service-9q1ibk@gcp-sa-apigee-uap.iam.gserviceaccount.com'dir.
  6. +Başka Rol Ekle düğmesini tıklayın ve aşağıdaki rolleri ekleyin:
    • BigQuery Kullanıcısı
    • Depolama Alanı Yöneticisi
  7. Kaydet'i tıklayın.

Apigee Analytics verileri

Apigee Analytics, API'lerinizde akan geniş bir veri yelpazesini toplar ve analiz eder. Ayrıca, API proxy performansındaki trendleri belirleyen etkileşimli kontrol panelleri, özel raporlar ve diğer araçlar gibi görselleştirme araçları sunar. Artık Apigee Analytics'ten analiz verilerini Google Cloud Storage veya Google BigQuery gibi kendi veri deponuza aktararak bu zengin içeriğin kilidini açabilirsiniz. Ardından, kendi veri analizinizi yapmak için Google BigQuery ve TensorFlow'un sunduğu güçlü sorgu ve makine öğrenimi özelliklerinden yararlanabilirsiniz. Ayrıca, kullanıcılarınız, API'leriniz ve uygulamalarınız hakkında yeni analizler elde etmek için dışa aktarılan analiz verilerini web günlükleri gibi diğer verilerle birleştirebilirsiniz.

Veri biçimi dışa aktarma

Analytics verilerini aşağıdaki biçimlerden birine aktarın:

  • Virgülle ayrılmış değerler (CSV)

    Varsayılan ayırıcı, virgül (,) karakteridir. Desteklenen sınırlayıcı karakterler arasında virgül (,), dikey çizgi (|) ve sekme (\t) bulunur. csvDelimiter özelliğini kullanarak değeri yapılandırın. Bu işlem, Dışa aktarma isteği özelliği referansı bölümünde açıklanmıştır.

  • JSON (yeni satırla ayrılmış)

    Yeni satır karakterinin ayırıcı olarak kullanılmasına izin verir.

Dışa aktarılan veriler, Edge'e yerleştirilmiş tüm Analytics metriklerini ve boyutlarını ve eklediğiniz tüm özel Analytics verilerini içerir. Dışa aktarılan verilerin açıklaması için Analytics metrikleri, boyutları ve filtreleri referansı başlıklı makaleyi inceleyin.

Analiz verilerini aşağıdaki veri depolarına aktarabilirsiniz:

Dışa aktarma sürecine genel bakış

Aşağıdaki adımlarda, analiz verilerinizi dışa aktarmak için kullanılan süreç özetlenmiştir:

  1. Veri dışa aktarma için veri deponuzu (Cloud Storage veya BigQuery) yapılandırın. Veri deponuzun doğru şekilde yapılandırıldığından ve veri deposuna veri yazmak için kullanılan hizmet hesabının doğru izinlere sahip olduğundan emin olmanız gerekir.

  2. Veri deposuna erişmek için kullanılan kimlik bilgileri de dahil olmak üzere verilerinizi dışa aktardığınız veri deposunun (Cloud Storage veya BigQuery) özelliklerini tanımlayan bir veri deposu oluşturun.

    Bir veri deposu oluşturduğunuzda, veri deposu kimlik bilgilerini güvenli bir şekilde saklamak için Edge Credentials Vault'a yüklersiniz. Veri dışa aktarma mekanizması, verileri veri deponuza yazmak için bu kimlik bilgilerini kullanır.

  3. Veri dışa aktarma işlemini başlatmak için veri dışa aktarma API'sini kullanın. Veri dışa aktarma işlemi arka planda eşzamansız olarak çalışır.

  4. Dışa aktarma işleminin ne zaman tamamlandığını belirlemek için veri dışa aktarma API'sini kullanın.

  5. Dışa aktarma işlemi tamamlandığında veri deponuzda dışa aktarılan verilere erişin.

Aşağıdaki bölümlerde bu adımlar daha ayrıntılı olarak açıklanmıştır.

Veri deponuzu yapılandırma

Analiz verilerini dışa aktarma mekanizması, verileri Cloud Storage veya BigQuery'ye yazar. Yazma işleminin gerçekleşmesi için yapmanız gerekenler:

  • Google Cloud Platform hizmet hesabı oluşturun.
  • Hizmet hesabının rolünü Cloud Storage veya BigQuery'ye erişebilecek şekilde ayarlayın.

Cloud Storage veya BigQuery için hizmet hesabı oluşturma

Hizmet hesabı, bireysel bir kullanıcıya değil, uygulamanıza ait olan bir Google Hesabı türüdür. Uygulamanız daha sonra bir hizmete erişmek için hizmet hesabını kullanır.

Hizmet hesabının, JSON dizesiyle temsil edilen bir hizmet hesabı anahtarı vardır. Veri deponuzla bağlantıyı tanımlayan Edge veri deposunu oluşturduğunuzda bu anahtarı iletirsiniz. Veri dışa aktarma mekanizması, veri deponuza erişmek için anahtarı kullanır.

Anahtarla ilişkili hizmet hesabı, Google Cloud Platform projesinin sahibi olmalı ve Google Cloud Storage paketine yazma erişimine sahip olmalıdır. Servis anahtarı oluşturma ve gerekli yükü indirme hakkında bilgi edinmek için Google Cloud Platform belgelerindeki Hizmet Hesabı Anahtarları Oluşturma ve Yönetme başlıklı makaleyi inceleyin.

Örneğin, anahtarınızı ilk kez indirdiğinizde JSON nesnesi olarak biçimlendirilir:

{ 
  "type": "service_account", 
  "project_id": "myProject", 
  "private_key_id": "12312312", 
  "private_key": "-----BEGIN PRIVATE KEY-----\n...", 
  "client_email": "client_email@developer.gserviceaccount.com", 
  "client_id": "879876769876", 
  "auth_uri": "https://accounts.google.com/organizations/oauth2/auth", 
  "token_uri": "https://oauth2.googleapis.com/token", 
  "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2", 
  "client_x509_cert_url": "https://www.googleapis.com" 
}

Google Cloud Storage'ı yapılandırma

Verileri Google Cloud Storage'a aktarabilmek için:

  • Google Cloud Platform projenizde BigQuery ve Cloud Resource Manager API'lerinin etkinleştirildiğinden emin olun. Talimatlar için API'leri etkinleştirme başlıklı makaleyi inceleyin. Apigee, Cloud Storage'a aktarırken BigQuery dışa aktarma özelliklerinden yararlanmak için BigQuery API'yi, her dışa aktarma işleminden önce izni kontrol etmek için ise Cloud Resource Manager API'yi kullanır.
  • Hizmet hesabının aşağıdaki rollere atandığından emin olun:

    • BigQuery İş Kullanıcısı
    • Depolama Alanı Nesne Oluşturucu
    • Depolama yöneticisi (yalnızca Veri deposu yapılandırmasını test etme bölümünde açıklandığı gibi veri deposunu test etmek için gereklidir). Bu rol çok geniş kapsamlıysa bunun yerine mevcut bir role storage.buckets.get iznini ekleyebilirsiniz.)

    Alternatif olarak, mevcut bir rolü değiştirmek veya özel bir rol oluşturmak istiyorsanız role aşağıdaki izinleri ekleyin:

Google BigQuery'yi yapılandırma

Verileri Google BigQuery'ye aktarabilmek için:

  • Google Cloud Platform projenizde BigQuery ve Cloud Resource Manager API'lerinin etkinleştirildiğinden emin olun. Talimatlar için API'leri etkinleştirme başlıklı makaleyi inceleyin. Apigee, her dışa aktarma işleminden önce izni kontrol etmek için Cloud Resource Manager API'yi kullanır.
  • Google Cloud Platform projenizde BigQuery API'nin etkinleştirildiğinden emin olun. Talimatlar için API'leri Etkinleştirme ve Devre Dışı Bırakma başlıklı makaleye bakın.
  • Hizmet hesabının aşağıdaki rollere atandığından emin olun:

    • BigQuery İş Kullanıcısı
    • BigQuery Veri Düzenleyicisi

    Mevcut bir rolü değiştirmek veya özel bir rol oluşturmak istiyorsanız role aşağıdaki izinleri ekleyin:

    • bigquery.datasets.create
    • bigquery.datasets.get
    • bigquery.jobs.create
    • bigquery.tables.create
    • bigquery.tables.get
    • bigquery.tables.updateData

Veri deposu oluşturma

Veri deposu, veri deposuna erişmek için kullanılan kimlik bilgileri de dahil olmak üzere dışa aktarılan veri deponuzla (Cloud Storage, BigQuery) bağlantıyı tanımlar.

Edge Credentials Vault hakkında

Edge, dışa aktarma veri deponuza erişmek için kullanılan kimlik bilgilerini güvenli bir şekilde depolamak üzere Kimlik Bilgileri Kasası'nı kullanır. Bir hizmetin Edge Credentials Vault'taki kimlik bilgilerine erişebilmesi için kimlik bilgisi tüketicisi tanımlamanız gerekir.

Aşağıda açıklandığı gibi Edge kullanıcı arayüzünü kullanarak bir veri deposu oluşturduğunuzda Edge, kimlik bilgilerine erişmek için kullanılan tüketiciyi otomatik olarak oluşturur.

Veri deposu yapılandırmasını test etme

Veri deposunu oluşturduğunuzda Edge, kimlik bilgilerinizin ve veri deposu yapılandırmanızın geçerli olup olmadığını test etmez veya doğrulamaz. Bu nedenle, veri deposunu oluşturabilir ve ilk veri dışa aktarma işleminizi çalıştırana kadar herhangi bir hata algılamayabilirsiniz.

Alternatif olarak, veri deposunu oluşturmadan önce yapılandırmasını test edin. Büyük bir veri dışa aktarma işleminin yürütülmesi uzun zaman alabileceğinden test yapmak faydalıdır. Büyük miktarda veri indirmeye başlamadan önce kimlik bilgilerinizi ve veri deposu yapılandırmanızı test ederek ayarlarınızla ilgili sorunları hızlıca düzeltebilirsiniz.

Test başarılı olursa veri deposunu oluşturun. Test başarısız olursa hataları düzeltip yapılandırmayı yeniden test edin. Veri deposunu yalnızca testler başarılı olduktan sonra oluşturursunuz.

Test özelliğini etkinleştirmek için:

Veri deposu oluşturma

Kullanıcı arayüzünde veri deposu oluşturmak için:

  1. https://apigee.com/edge adresine kuruluş yöneticisi olarak giriş yapın ve kuruluşunuzu seçin.

    NOTE: Veri deposu oluşturabilmek için Edge kuruluş yöneticisi olmanız gerekir.

  2. Soldaki gezinme çubuğundan Yönetici > Analytics Veri Depoları'nı seçin. Analytics Veri Depoları sayfası görüntülenir.

  3. + Veri deposu ekle düğmesini seçin. Veri deposu türünü seçmeniz istenir:

  4. Dışa aktarılan verilerin hedef türünü seçin:

    • Google Cloud Storage
    • Google BigQuery

    Yapılandırma sayfası görüntülenir:

  5. Veri deposunun Adı'nı girin.

  6. Veri deposuna erişmek için kullanılan bir kimlik bilgisi seçin. Kullanılabilir kimlik bilgilerinin açılır listesi gösterilir.

    Kimlik bilgileri, veri deposu türüne özgüdür. Daha fazla bilgi için Cloud Storage veya BigQuery için hizmet hesabı oluşturma başlıklı makaleyi inceleyin.

    • Kimlik bilgilerini zaten yüklediyseniz açılır listeden kimlik bilgilerini seçin. Veri deposu türüne uygun kimlik bilgilerini seçtiğinizden emin olun.

    • Veri deposuna yeni kimlik bilgileri ekliyorsanız Yeni ekle'yi seçin. İletişim kutusuna şunları girin:

      1. Kimlik bilgisi adı.
      2. Kimlik bilgileri içeriği, Cloud Storage veya BigQuery için hizmet hesabı oluşturma bölümünde tanımlandığı gibi, veri deponuza özel JSON hizmet hesabı anahtarıdır.
      3. Oluştur'u seçin.
  7. Veri deposu türüne özgü özellikleri girin:

    • Google Cloud Storage için:
      Mülk Açıklama Zorunlu mu?
      Proje kimliği Google Cloud Platform proje kimliği.

      Google Cloud Platform projesi oluşturmak için Google Cloud Platform belgelerindeki Proje Oluşturma ve Yönetme başlıklı makaleyi inceleyin.

      Evet
      Paket Adı Analiz verilerini dışa aktarmak istediğiniz Cloud Storage paketinin adı. Veri dışa aktarma işlemi gerçekleştirmeden önce paketin mevcut olması gerekir.

      Cloud Storage paketi oluşturmak için Google Cloud Platform belgelerindeki Depolama Paketi Oluşturma başlıklı makaleyi inceleyin.

      Evet
      Yol Cloud Storage paketinde analiz verilerinin depolanacağı dizin. Evet
    • BigQuery için:
      Mülk Açıklama Zorunlu mu?
      Proje kimliği Google Cloud Platform proje kimliği.

      Google Cloud Platform projesi oluşturmak için Google Cloud Platform belgelerindeki Proje Oluşturma ve Yönetme başlıklı makaleyi inceleyin.

      Evet
      Veri Kümesi Adı Analytics verilerini aktarmak istediğiniz BigQuery veri kümesinin adı. Veri dışa aktarma isteğinde bulunmadan önce veri kümesinin oluşturulduğundan emin olun.

      BigQuery veri kümesi oluşturmak için Google Cloud Platform belgelerindeki Veri Kümeleri Oluşturma ve Kullanma başlıklı makaleye bakın.

      Evet
      Tablo öneki BigQuery veri kümesindeki analiz verileri için oluşturulan tabloların adlarının ön eki. Evet
  8. Kimlik bilgilerinin veri deposuna erişmek için kullanılabildiğinden emin olmak üzere Bağlantıyı test et'i seçin.

    Test başarılı olursa veri deponuzu kaydedin.

    Test başarısız olursa sorunları düzeltip testi yeniden deneyin. Kullanıcı arayüzündeki hata mesajının üzerine fareyle gelin. İpucunda ek bilgiler gösterilir.

  9. Bağlantı testi başarılı olduktan sonra veri deposunu kaydedin.

Veri deposunu değiştirme

Veri deposunu değiştirmek için:

  1. https://apigee.com/edge adresine kuruluş yöneticisi olarak giriş yapın ve kuruluşunuzu seçin.

  2. Soldaki gezinme çubuğundan Yönetici > Analytics Veri Depoları'nı seçin. Analytics Veri Depoları sayfası görüntülenir.

  3. Fare işaretçisini, değiştirilecek raporun Değiştirildi sütununun üzerine getirin. Düzenle ve sil simgesi görünür.

  4. Veri deposunu düzenleyin veya silin.

  5. Veri deposunu düzenlediyseniz kimlik bilgilerinin veri deposuna erişmek için kullanılabildiğinden emin olmak üzere Bağlantıyı test et'i seçin.

    Test başarılı olursa örnek verileri veri deponuzda görüntüleyebilirsiniz.

    Test başarısız olursa sorunları düzeltip testi yeniden deneyin.

  6. Bağlantı testi başarılı olduktan sonra veri deposunu güncelleyin.

Analiz verilerini dışa aktarma

Analytics verilerini dışa aktarmak için /analytics/exports API'ye bir POST isteği gönderin. İstek gövdesinde aşağıdaki bilgileri iletin:

  • Dışa aktarma isteğinin adı ve açıklaması
  • Dışa aktarılan verilerin tarih aralığı (değer yalnızca bir günü kapsayabilir)
  • Dışa aktarılan verilerin biçimi
  • Mağaza adı
  • Kuruluşta para kazanmanın etkin olup olmadığı

Aşağıda dışa aktarma istekleriyle ilgili örnekler verilmiştir. İstek gövdesi özelliklerinin tam açıklaması için Export request property reference (Dışa aktarma isteği özelliği referansı) başlıklı makaleyi inceleyin.

POST'tan gelen yanıt şu biçimdedir:

{
    "self": "/organizations/myorg/environments/test/analytics/exports/a7c2f0dd-1b53-4917-9c42-a211b60ce35b",
    "created": "2017-09-28T12:39:35Z",
    "state": "enqueued"
}

Yanıtın state özelliğinin enqueued olarak ayarlandığını unutmayın. POST isteği eşzamansız olarak çalışır. Bu nedenle, istek yanıt döndürdükten sonra arka planda çalışmaya devam eder. state için olası değerler şunlardır: enqueued, running, completed, failed.

Veri dışa aktarma isteğinin durumunu görüntülemek için Bir Analytics dışa aktarma isteğinin durumunu görüntüleme başlıklı makalede açıklandığı gibi self özelliğinde döndürülen URL'yi kullanın. İstek tamamlandığında yanıttaki state özelliğinin değeri completed olarak ayarlanır. Ardından, veri deponuzdaki analiz verilerine erişebilirsiniz.

1. örnek: Verileri Cloud Storage'a aktarma

Aşağıdaki istek, myorg kuruluşundaki test ortamından son 24 saate ait ham verilerin tamamını dışa aktarır. İçerik, JSON biçiminde Cloud Storage'a aktarılır:

curl -X POST -H "Content-Type:application/json" \
"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -d \
  '{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository"
  }' \
  -u orgAdminEmail:password

self özelliği tarafından belirtilen URI'yi kullanarak iş durumunu Analiz dışa aktarma isteğinin durumunu görüntüleme bölümünde açıklandığı şekilde izleyin.

2. örnek: Verileri BigQuery'ye aktarma

Aşağıdaki istek, virgülle ayrılmış bir CSV dosyasını BigQuery'ye aktarır:

curl -X POST -H "Content-Type:application/json"  \
  "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -d \
  '{
    "name": "Export query results to BigQuery",
    "description": "One-time export to BigQuery",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "csv",
    "csvDelimiter": ",", 
    "datastoreName": "My BigQuery data repository"
  }' \
  -u orgAdminEmail:password

Not: Dışa aktarılan CSV dosyası, aşağıdaki öneke sahip bir BigQuery tablosu oluşturur:

<PREFIX>_<EXPORT_DATE>_api_<UUID>_from_<FROM_DATE>_to_<TO_DATE>

self özelliği tarafından belirtilen URI'yi kullanarak iş durumunu Analiz dışa aktarma isteğinin durumunu görüntüleme bölümünde açıklandığı şekilde izleyin.

3. örnek: Para kazanma verilerini dışa aktarma

Kuruluşta bir ortamda para kazanma etkinleştirilmişse iki tür veri dışa aktarma işlemi gerçekleştirebilirsiniz:

  • Önceki iki örnekte gösterildiği gibi standart veri dışa aktarma.
  • Para kazanma verilerini dışa aktarma: Para kazanmayla ilgili verileri dışa aktarmak için kullanılır.

Para kazanma verilerini dışa aktarma işlemi gerçekleştirmek için istek yükünde "dataset":"mint" değerini belirtin. Bu seçeneği ayarlamak için kuruluş ve ortam para kazanmayı desteklemelidir. Aksi takdirde, dataset özelliğini yükten çıkarın:

  '{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository",
    "dataset":"mint"
  }'

Export API kotaları hakkında

Pahalı veri dışa aktarma API çağrılarının aşırı kullanılmasını önlemek için Edge, /analytics/exports API'ye yapılan çağrılar için bir kota uygular:

  • Para kazanma özelliği etkin olmayan kuruluşlar ve ortamlar için kota:

    • Kuruluş/ortam başına ayda 70 çağrı.

    Örneğin, kuruluşunuzda prod ve test olmak üzere iki ortamınız varsa her ortam için ayda 70 API çağrısı yapabilirsiniz.

  • Para kazanma özelliği etkinleştirilmiş kuruluşlar ve ortamlar için kota:

    • Her kuruluş ve ortam için standart verilerde ayda 70 çağrı.
    • Para kazanma verileri için her kuruluş ve ortamda ayda 70 çağrı.

    Örneğin, prod kuruluşunuzda para kazanmayı etkinleştirirseniz standart veriler için 70 API çağrısı ve para kazanma verileri için 70 ek API çağrısı yapabilirsiniz.

Çağrı kotasını aşarsanız API, HTTP 429 yanıtı döndürür.

Tüm Analytics dışa aktarma isteklerinin durumunu görüntüleme

Tüm Analytics dışa aktarma isteklerinin durumunu görüntülemek için GET isteği gönderin. /analytics/exports

Örneğin, aşağıdaki istek, myorg kuruluşundaki test ortamıyla ilgili tüm analiz dışa aktarma isteklerinin durumunu döndürür:

curl -X GET \
  "https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports" \
  -u email:password

Aşağıda, biri sıraya alınmış (oluşturulmuş ve sırada) diğeri tamamlanmış iki dışa aktarma isteğini listeleyen yanıt örneği verilmiştir:

[
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/e8b8db22-fe03-4364-aaf2-6d4f110444ba",
    "name": "Export results To Cloud Storage",
    "description": "One-time export to Google Cloud Storage",
    "userId": "my@email.com",
    "datastoreName": "My Cloud Storage data store",
    "executionTime": "36 seconds",
    "created": "2018-09-28T12:39:35Z",
    "updated": "2018-09-28T12:39:42Z",
    "state": "enqueued"
  },
  {
    "self":
"/v1/organizations/myorg/environments/test/analytics/exports/9870987089fe03-4364-aaf2-6d4f110444ba"
    "name": "Export raw results to BigQuery",
    "description": "One-time export to BigQuery",
    ... 
  }
]

Analytics dışa aktarma isteğinin durumunu görüntüleme

Belirli bir analiz dışa aktarma isteğinin durumunu görüntülemek için GET isteğini /analytics/exports/{exportId} adresine gönderin. Burada {exportId}, analiz dışa aktarma isteğiyle ilişkili kimliktir.

Örneğin, aşağıdaki istek, 4d6d94ad-a33b-4572-8dba-8677c9c4bd98 kimlikli analiz dışa aktarma isteğinin durumunu döndürür.

curl -X GET \
"https://api.enterprise.apigee.com/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98" \
-u email:password

Aşağıda, yanıta dair bir örnek verilmiştir:

{
  "self":
"/v1/organizations/myorg/environments/test/analytics/exports/4d6d94ad-a33b-4572-8dba-8677c9c4bd98",
  "name": "Export results To Cloud Storage",
  "description": "One-time export to Google Cloud Storage",
  "userId": "my@email.com",
  "datastoreName": "My Cloud Storage data store",
  "executionTime": "36 seconds",
  "created": "2018-09-28T12:39:35Z",
  "updated": "2018-09-28T12:39:42Z",
  "state": "enqueued"
}

Analytics dışa aktarma işlemi herhangi bir Analytics verisi döndürmezse executionTime değeri "0 saniye" olarak ayarlanır.

Dışa aktarma isteği mülk referansı

Aşağıdaki tabloda, analiz verilerini dışa aktarırken istek gövdesinde JSON biçiminde iletebileceğiniz özellikler açıklanmaktadır.

Mülk Açıklama Zorunlu mu?
description Dışa aktarma isteğinin açıklaması. Hayır
name Dışa aktarma isteğinin adı. Evet
dateRange

Dışa aktarılacak verilerin start ve end tarihini yyyy-mm-dd biçiminde belirtin. Örneğin:

"dateRange": {
    "start": "2018-07-29",
    "end": "2018-07-30"
}

dateRange değeri yalnızca bir günü kapsayabilir. Tarih aralığı, start tarihinde 00:00:00 UTC'de başlar ve end tarihinde 00:00:00 UTC'de sona erer.

NOT: Önceki güne ait tüm verilerin yakalandığından emin olmak için dışa aktarma isteğinin başlangıç zamanını geciktirmeniz gerekebilir (ör. 00:05:00 UTC).

Evet
outputFormat json veya csv olarak belirtin. Evet
csvDelimiter

outputFormat, csv olarak ayarlanmışsa CSV çıkış dosyasında kullanılan sınırlayıcı. Varsayılan olarak , (virgül) karakterine ayarlanır. Desteklenen sınırlayıcı karakterler arasında virgül (,), dikey çizgi (|) ve sekme (\t) bulunur.

Hayır
datastoreName Veri deponuzun tanımını içeren veri deposunun adı. Evet

Örneğin:

{
    "name": "Export raw results to Cloud Storage",
    "description": "Export raw results to Cloud Storage for last 24 hours",
    "dateRange": {
      "start": "2018-06-08", 
      "end": "2018-06-09"
    },
    "outputFormat": "json",
    "datastoreName": "My Cloud Storage data repository"
  }