Mengekspor data Layanan Saluran ke BigQuery

Catatan: Ekspor ini hanya tersedia untuk partner Google Cloud dan Google Workspace. Data penagihan Google Workspace Essentials dan Google Voice tidak disertakan dalam BigQuery Export.

Halaman ini menunjukkan cara mengonfigurasi ekspor Layanan Saluran, dan juga menjelaskan skema yang tersedia untuk ekspor.

Dengan BigQuery, Anda dapat mengekspor data penagihan Layanan Saluran ke set data BigQuery yang ditentukan. Data ini dapat membantu Anda melakukan analisis mendetail tentang cara pelanggan atau partner saluran menggunakan layanan yang Anda berikan.

Ekspor dari Layanan Saluran berisi data khusus reseller yang tidak disertakan dalam ekspor Penagihan Cloud. Ekspor ini mencakup data biaya, kredit, dan penggunaan dengan aturan penetapan ulang harga yang dikonfigurasi. Ekspor ini juga menggabungkan semua informasi tentang akun penagihan induk pelanggan Anda ke dalam satu set data.

Namun, data dari ekspor Layanan Saluran kompatibel dengan ekspor Penagihan Cloud, dan Anda dapat menggunakan kueri untuk menggabungkan kedua set data tersebut untuk dianalisis.

Untuk informasi tentang ekspor Penagihan Cloud non-reseller, lihat menyiapkan ekspor Penagihan Cloud ke BigQuery.

Sebelum memulai

Sebelum mulai mengekspor data penagihan Layanan Saluran, Anda harus:

• Siapkan project untuk menghosting set data BigQuery Anda. Pastikan penagihan diaktifkan pada project.
• Aktifkan BigQuery Data Transfer Service API pada project.
• Buat set data untuk data yang diekspor.

Jika Anda sudah memiliki project dan set data BigQuery untuk ekspor data Cloud Billing, Anda dapat menggunakan kembali project dan set data tersebut untuk ekspor Layanan Saluran.

Untuk mengetahui informasi lebih lanjut tentang cara menyiapkan project dan set data, lihat Menyiapkan ekspor data Penagihan Cloud ke BigQuery.

Izin yang diperlukan untuk ekspor

Untuk mengaktifkan dan mengonfigurasi ekspor Layanan Saluran, Anda memerlukan peran berikut:

• Untuk BigQuery, jika membuat set data target, Anda memerlukan BigQuery User untuk project yang berisi set data tersebut. Jika set data dibuat oleh orang lain, Anda memerlukan peran BigQuery Data Owner.

• Untuk mengaktifkan ekspor Google Cloud, di Partner Sales Console, Anda harus memiliki peran administrator Reseller Google Cloud.

  Pelajari cara menetapkan peran Google Cloud di Partner Sales Console

• Untuk mengaktifkan ekspor Google Workspace, Anda harus menjadi Admin Reseller atau memiliki hak istimewa Penagihan Google Workspace.

  Pelajari cara menetapkan peran Google Workspace di Partner Sales Console

• (Opsional) Project Viewer untuk project yang berisi set data BigQuery target, untuk memeriksa secara otomatis apakah penagihan diaktifkan pada project.

Pilih project dan set data

Di Partner Sales Console, pilih project dan set data di BigQuery untuk menyimpan data Layanan Saluran. Mengaktifkan penagihan pada project jika belum diaktifkan.

Saat memilih atau membuat set data BigQuery, Anda dapat memilih salah satu lokasi BigQuery yang didukung untuk set data tersebut. Jika Anda mengaktifkan ekspor data Layanan Saluran untuk pertama kalinya per sumber data (Google Cloud atau Google Workspace):

• Jika Anda mengonfigurasi set data BigQuery untuk menggunakan lokasi multi-region, data BigQuery Export akan tersedia untuk setiap sumber data yang dipilih sejak awal bulan sebelumnya. Misalnya, jika Anda mengaktifkan BigQuery Export pada 23 September, ekspor akan menyertakan data mulai 1 Agustus.

• Jika Anda mengonfigurasi set data BigQuery untuk menggunakan lokasi region (selain multi-region AS atau Uni Eropa), data BigQuery Export akan tersedia untuk setiap sumber data yang dipilih sejak tanggal Anda mengaktifkan ekspor, dan setelahnya. Artinya, data BigQuery Export tidak ditambahkan secara retroaktif untuk lokasi set data non-multi-region, sehingga Anda tidak akan melihat data BigQuery Export sebelum mengaktifkan ekspor.

Peringatan: Bagi Partner yang nantinya menonaktifkan dan mengaktifkan kembali BigQuery Export atau mengubah set data Export ke lokasi BigQuery yang berbeda, data mungkin tidak tersedia untuk periode saat ekspor dinonaktifkan secara eksplisit atau antara ekspor terakhir dan saat perubahan set data lintas region terjadi. Dalam kasus ini, kami tidak dapat mengisi ulang data.

Untuk mengekspor data penagihan ke beberapa akun Partner Sales Console, ikuti langkah-langkah berikut:

1. Pada set data BigQuery yang ingin dijadikan tujuan ekspor data, pastikan Billing Administrator untuk setiap akun Partner Sales Console memiliki izin untuk melihat set data.
2. Saat Anda menyiapkan ekspor data penagihan di setiap akun Partner Sales Console, pilih set data terpadu.

Lokasi BigQuery yang didukung

Multi-region

Tabel berikut mencantumkan multi-region tempat ekspor data BigQuery Layanan Saluran didukung.

Deskripsi multi-region	Nama multi-region
Pusat data di negara anggota Uni Eropa^1	EU
Pusat data di Amerika Serikat	US

Region

Tabel berikut berisi daftar region di Amerika tempat ekspor data BigQuery Layanan Saluran didukung.

Deskripsi region	Nama region
Iowa	us-central1
Las Vegas	us-west4
Los Angeles	us-west2
Montréal	northamerica-northeast1
Northern Virginia	us-east4
Oregon	us-west1
Salt Lake City	us-west3
Sao Paulo	southamerica-east1
South Carolina	us-east1

Tabel berikut berisi daftar region di Asia Pasifik tempat ekspor data BigQuery Layanan Saluran didukung.

Deskripsi region	Nama region
Hong Kong	asia-east2
Jakarta	asia-southeast2
Mumbai	asia-south1
Osaka	asia-northeast2
Seoul	asia-northeast3
Singapura	asia-southeast1
Sydney	australia-southeast1
Taiwan	asia-east1
Tokyo	asia-northeast1

Tabel berikut berisi daftar region di Eropa tempat ekspor data BigQuery Layanan Saluran didukung.

Deskripsi region	Nama region
Belgia	europe-west1
Finlandia	europe-north1
Frankfurt	europe-west3
London	europe-west2
Belanda	europe-west4
Warsawa	europe-central2
Zürich	europe-west6

Aktifkan ekspor

Sebelum mengaktifkan ekspor data, catat ID set data Anda yang sepenuhnya memenuhi syarat, dengan format PROJECT_ID:DATASET_NAME.

Perhatian: Jika Anda belum mengaktifkan Penagihan pada project, BigQuery mungkin berjalan dalam mode sandbox, yang dapat menyebabkan ekspor berperilaku tidak terduga. Pelajari cara mengupgrade dari sandbox BigQuery.

Untuk mengaktifkan ekspor Layanan Saluran:

1. Di Partner Sales Console, buka halaman Billing.
2. Pilih Ekspor penagihan.
3. Masukkan ID set data yang sepenuhnya memenuhi syarat di kolom Set data penagihan ulang.
4. Pilih Sumber data yang datanya ingin diekspor.
5. Klik Perbarui. Jika Anda melihat perintah untuk memperbarui izin set data, klik Update.

Setelah disiapkan, ekspor penagihan akan mengirimkan data penggunaan inkremental setiap hari. Tabel ekspor tidak akan ditampilkan hingga ekspor penagihan berjalan untuk akun Anda untuk pertama kalinya. Set data berisi data sejak pertama kali dikonfigurasi untuk menyimpan data.

Peringatan: Jangan ubah tabel data yang diekspor.

Mengubah tabel ini dapat menyebabkan ekspor data dihentikan. Data yang ditambahkan secara manual akan hilang sampai Anda mengembalikan perubahan atau menghapus tabel. Jika Anda ingin menggabungkan data dari ekspor Penagihan Cloud sebelumnya ke BigQuery, sebaiknya simpan data dalam tabel terpisah dan gunakan kueri UNION.

Untuk berhenti mengekspor data biaya penagihan ulang ke set data, klik Nonaktifkan ekspor data penagihan di halaman Penagihan ulang pelanggan. Untuk mengaktifkan kembali ekspor, ikuti langkah-langkah sebelumnya untuk menentukan ID set data.

Data biaya penagihan ulang mungkin tidak tersedia selama durasi penonaktifannya. Jika Anda menghapus data apa pun yang diekspor selama waktu tersebut, kami tidak dapat mengisi ulang data yang dihapus.

Izin akun layanan yang diperlukan

Ekspor data Layanan Saluran menggunakan akun layanan yang dimiliki dan dikelola oleh Google, dan memiliki izin untuk menulis data penagihan ke tabel. Akun layanannya adalah:

[e-mail]

Akun layanan ini memerlukan peran standar: roles/bigquery.dataEditor agar dapat mengizinkan ekspor. Anda dapat mengonfigurasi izin dengan mengikuti langkah-langkah untuk mengaktifkan ekspor.

Peringatan: Menghapus akun layanan ini saat ekspor penagihan ke BigQuery diaktifkan dapat mengakibatkan hilangnya data.

Jika akun layanan dihapus, Anda harus menambahkan akun layanan lagi atau mengonfigurasi ulang izin set data dengan mengklik tombol Update di halaman Billing export. Kami tidak dapat mengisi ulang data yang dihapus atau diekspor jika Anda menghapus data yang diekspor atau jika Anda mengalihkan ekspor ke set data yang berbeda.

Membuat kueri data secara efisien

Tabel BigQuery dipartisi oleh export_time dan dikelompokkan berdasarkan payer_billing_account_id secara default. Ini berarti tabel dibagi menjadi partisi yang lebih kecil, masing-masing dibagi lagi menjadi beberapa cluster yang lebih kecil. Menggunakan kunci partisi dan cluster dalam kueri akan membantu BigQuery menemukan data yang relevan dengan cepat, sehingga dapat mengurangi biaya kueri secara signifikan.

Misalnya, kueri di bawah ini efisien dibandingkan dengan kueri tanpa partisi dan kunci pengelompokan:

SELECT
  billing_account_id
  currency,
  invoice.month,
  -- Divide by currency_conversion_rate if converting non-USD to USD.
  SUM(cost)
    + SUM(
      IFNULL(
        (SELECT SUM(c.amount) FROM UNNEST(credits) AS c), 0))
    AS total
FROM PROJECT_ID.DATASET_NAME.reseller_billing_detailed_export_v1
WHERE
  export_time BETWEEN TIMESTAMP(START_DATE)
    AND TIMESTAMP(END_DATE)
  AND payer_billing_account_id IN (PAYER_BILLING_ACCOUNT_IDS)
GROUP BY
  billing_account_id,
  currency,
  invoice.month
ORDER BY
  billing_account_id,
  currency,
  invoice.month;

Untuk informasi lebih lanjut tentang partisi, pengelompokan, dan praktik terbaik, lihat link berikut:

1. Membuat kueri untuk Tabel yang dipartisi
2. Membuat kueri untuk Tabel yang dikelompokkan
3. Mengoptimalkan komputasi kueri
4. Praktik Terbaik untuk mengontrol biaya di BigQuery

Menemukan ID akun penagihan pembayar

Untuk menemukan ID akun penagihan pembayar, buka halaman akun penagihan di Partner Sales Console, lalu klik tab Penagihan partner.

Anda dapat melihat semua akun penagihan dan ID akun penagihan pembayar.

Menyiapkan kontrol akses untuk pengguna lain di set data ekspor

Ada beberapa cara untuk menyiapkan kontrol akses pada data di BigQuery Export. Untuk mengetahui informasi lebih lanjut, lihat Kontrol akses BigQuery.

Untuk memastikan pengguna hanya memiliki akses ke data yang boleh mereka lihat, sebaiknya siapkan Tampilan yang diotorisasi untuk membagikan data dari set data yang diekspor.

Perhatian: Jangan gunakan kontrol akses tingkat baris atau tingkat kolom pada set data. Mengaktifkan fitur kontrol akses ini akan menyebabkan ekspor data penagihan gagal.

Saat menyiapkan izin untuk pengguna, pastikan akun layanan [e-mail] selalu memiliki akses editor penuh di set data ekspor untuk ekspor data berkelanjutan.

Skema tabel

Peringatan: Mencoba mengubah skema ekspor sendiri dapat mengakibatkan data tidak lagi diekspor. Jika ingin menambahkan atau menghapus kolom, Anda dapat membuat tampilan atau tampilan terwujud, atau Anda dapat menggabungkannya dengan tabel lain dalam kueri.

Jika tabel Anda berada dalam status ini, Anda harus mengembalikannya memiliki semua kolom yang benar, bukan yang lainnya. Setelah itu, Anda mungkin harus membuka halaman Billing export, lalu mengklik Update.

Skema berikut menjelaskan data dalam tabel BigQuery.

Dalam set data BigQuery, ekspor penagihan ulang yang mendetail dimuat ke dalam tabel data bernama reseller_billing_detailed_export_v1.

Kolom	Jenis	Deskripsi
billing_account_id	String	ID akun yang terkait dengan penggunaan, yang mungkin milik pelanggan atau Anda. Bergantung pada kelompok produk, akun ini dapat berupa akun penagihan atau ID Cloud Identity.
payer_billing_account_id	String	ID akun penagihan induk Anda.
invoice.month	String	Tahun dan bulan (YYYYMM) invoice yang menyertakan item baris biaya. Misalnya: "202101" sama dengan Januari 2021.
cost_type	String	Jenis biaya yang dijelaskan dalam item baris ini: reguler, pajak, penyesuaian, atau kesalahan pembulatan.
service.id	String	ID layanan yang terkait dengan penggunaan.
service.description	String	Layanan Google yang melaporkan data penagihan.
sku.id	String	ID SKU dari resource yang digunakan oleh layanan.
sku.description	String	Deskripsi jenis resource yang digunakan oleh layanan. Misalnya, Cloud Storage adalah jenis Standard Storage US.
usage_start_time	Stempel waktu	Waktu mulai periode penggunaan per jam untuk biaya yang dihitung. Penggunaan dan biaya untuk semua layanan ditampilkan dengan perincian per jam. Penggunaan layanan yang berjalan lama tersebar di beberapa periode per jam. Untuk produk langganan, ini adalah awal bulan penagihan.
usage_end_time	Stempel waktu	Waktu berakhir periode penggunaan per jam untuk biaya yang dihitung. Penggunaan dan biaya untuk semua layanan ditampilkan dengan perincian per jam. Penggunaan layanan yang berjalan lama tersebar di beberapa periode per jam. Untuk produk langganan, ini adalah akhir bulan penagihan.
project	Struct	Informasi tentang project Google Cloud yang menghasilkan data Penagihan Cloud.
project.number	String	ID unik yang dibuat secara internal, anonim, dan unik untuk project Google Cloud yang membuat data Penagihan Cloud.
project.id	String	ID project Google Cloud yang menghasilkan data Penagihan Cloud.
project.name	String	Nama project Google Cloud yang menghasilkan data Penagihan Cloud.
project.labels	Struct, Berulang
project.labels.key	String	Jika ada label, bagian kunci dari pasangan nilai kunci.
project.labels.value	String	Jika ada label, bagian nilai dari pasangan nilai kunci.
project.ancestry_numbers	String	Ancestor hierarki resource untuk project yang diidentifikasi oleh project.id.
labels	Struct, Berulang
labels.key	String	Jika ada label, bagian kunci dari pasangan nilai kunci.
labels.value	String	Jika ada label, bagian nilai dari pasangan nilai kunci.
system_labels	Struct, Berulang
system_labels.key	String	Jika ada label sistem, bagian kunci dari pasangan nilai kunci.
system_labels.value	String	Jika ada label sistem, bagian nilai dari pasangan nilai kunci.
location.location	String	Lokasi penggunaan pada tingkat negara, region, atau zona. Menampilkan global untuk resource tanpa lokasi spesifik. Untuk mengetahui informasi selengkapnya, lihat Region dan Zona.
location.country	String	Jika location.location adalah negara, wilayah, atau zona, kolom ini adalah negara penggunaan. Contoh, US. Untuk mengetahui informasi selengkapnya, lihat Region dan Zona.
location.region	String	Jika location.location adalah negara atau wilayah, kolom ini adalah wilayah penggunaan. Contoh, us-central1. Untuk mengetahui informasi selengkapnya, lihat Region dan Zona.
location.zone	String	Jika location.location adalah zona, kolom ini adalah zona penggunaan. Contoh, us-central1-a. Untuk mengetahui informasi selengkapnya, lihat Region dan Zona.
resource	Struct	Menjelaskan struktur dan nilai informasi yang relevan dengan resource layanan (misalnya, virtual machine atau SSD) yang menghasilkan penggunaan layanan.
resource.name	String	ID khusus layanan untuk resource yang menghasilkan penggunaan yang relevan. Dapat dibuat oleh pengguna.
resource.global_name	String	ID layanan unik global untuk resource yang menghasilkan penggunaan relevan.
cost	Angka	Biaya penggunaan sebelum kredit yang diterapkan. Untuk mendapatkan total biaya termasuk kredit, tambahkan credits.amount ke cost.
currency	String	Mata uang penagihan biaya. Untuk mengetahui informasi selengkapnya, lihat Mata Uang Lokal untuk Penagihan dan Pembayaran.
currency_conversion_rate	Float	Nilai tukar dari dolar AS ke mata uang lokal. Artinya, cost ÷ currency_conversion_rate sama dengan biaya dalam dolar AS.
usage.amount	Angka	Jumlah usage.unit yang digunakan.
usage.unit	String	Unit dasar untuk mengukur penggunaan resource. Misalnya, unit dasar untuk penyimpanan standar adalah byte-detik.
usage.amount_in_pricing_unit	Angka	Jumlah penggunaan usage.pricing_unit.
usage.pricing_unit	String	Unit untuk mengukur penggunaan resource.
credits	Struct, Berulang	Berisi kolom yang mendeskripsikan struktur dan nilai kredit.
credits.id	String	Jika terisi, menunjukkan bahwa kredit terkait dengan SKU produk.
credits.full_name	String	Nama kredit yang terkait dengan SKU produk.
credits.type	String	Kolom ini menjelaskan tujuan atau asal credits.id.
credits.name	String	Deskripsi kredit yang diterapkan untuk penggunaan.
credits.amount	Angka	Jumlah kredit yang diterapkan untuk penggunaan.
credits.channel_partner_amount	Angka	Jumlah kredit yang diterapkan untuk penggunaan, setelah diskon dan markup penagihan ulang. Berdasarkan channel_partner_name dan ChannelPartnerRepricingConfig terkait. Jika credits.type adalah Reseller_MARGIN, jumlah ini akan menjadi nol.
credits.customer_amount	Angka	Jumlah kredit yang diterapkan untuk penggunaan, setelah diskon dan markup penagihan ulang. Berdasarkan customer_name dan CustomerRepricingConfig terkait. Jika credits.type adalah Reseller_MARGIN, jumlah ini akan menjadi nol.
adjustmentsInfo	Struct, Berulang	Berisi kolom yang mendeskripsikan struktur dan nilai penyesuaian untuk item baris biaya.
adjustmentsInfo.adjustment_id	String	Jika diisi, penyesuaian akan dikaitkan dengan item baris biaya. adjustmentsInfo.adjustments_id adalah ID unik untuk semua penyesuaian yang disebabkan oleh suatu masalah.
adjustmentsInfo.adjustment_description	String	Deskripsi penyesuaian dan penyebabnya.
adjustmentsInfo.adjustment_type	String	Jenis penyesuaian.
adjustmentsInfo.adjustment_mode	String	Cara penyesuaian tersebut dikeluarkan.
export_time	Stempel waktu	Waktu pemrosesan yang terkait dengan penambahan data penagihan. Waktu tersebut akan selalu meningkat seiring dengan adanya ekspor baru. Gunakan kolom export_time untuk memahami kapan data penagihan yang diekspor terakhir diperbarui.
entitlement_name	String	Nama resource Entitlement Cloud Channel API. Menggunakan format: accounts/{account}/customers/{customer}/entitlements/{entitlement}
channel_partner_name	String	(Khusus distributor) Nama resource partner saluran yang menjual kepada pelanggan akhir. Menggunakan format: accounts/{account}/channelPartnerLinks/{channelPartner}.
channel_partner_cost	Angka	(Khusus distributor) Biaya untuk partner saluran, yang diidentifikasi dengan channel_partner_name, setelah menerapkan ChannelPartnerRepricingConfig yang ada.
customer_name	String	Nama resource pelanggan reseller yang menggunakan penggunaan ini dalam format accounts/{account}/pelanggan/{customer}
customer_cost	Angka	Biaya untuk pelanggan reseller yang diidentifikasi dengan kolom customer_name, setelah menerapkan CustomerRepricingConfig, jika ada.
cost_at_list	Angka	Biaya jika ditagih dengan harga publik.
customer_repricing_config_name	String	Nama resource Cloud Channel API CustomerRepricingConfig. Menggunakan format: accounts/{account}/customers/{customer}/customerRepricingConfigs/{id}. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom ini adalah Januari 2023.
channel_partner_repricing_config_name	String	(Khusus Distributor) Nama resource Cloud Channel API ChannelPartnerRepricingConfig. Menggunakan format: accounts/{account}/channelPartnerLinks/{channelPartner}/channelPartnerRepricingConfigs/{id}. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom ini adalah Januari 2023.
tags	Struct	Kolom yang mendeskripsikan tag, seperti kunci, nilai, dan namespace. Catatan: Untuk Google Cloud, sebulan penuh pertama data dengan tag ini adalah Januari 2023.
tags.key	String	Nama pendek atau nama tampilan kunci yang terkait dengan tag khusus ini.
tags.value	String	Resource yang dilampirkan ke kunci tag. Pada waktu tertentu, hanya satu nilai yang dapat dilampirkan ke resource untuk kunci tertentu.
tags.inherited	Boolean	Menunjukkan apakah binding tag diwarisi (Tag Diwariskan = Benar) atau langsung/tidak diwarisi (Tag Diwarisi = False).
tags.namespace	String	Mewakili hierarki resource yang mendefinisikan nilai dan kunci tag. Namespace dapat digabungkan dengan kunci tag dan nama pendek nilai tag untuk membuat nama yang unik secara global dan sepenuhnya memenuhi syarat untuk kunci tag atau nilai tag.
customer_correlation_id	String	ID CRM eksternal untuk pelanggan. Hanya diisi jika ID CRM ada untuk pelanggan ini. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom ini adalah Maret 2023.
price	Struct	Kolom yang mendeskripsikan struktur dan nilai yang terkait dengan harga yang dikenakan untuk penggunaan. Catatan: Untuk Google Cloud, data sebulan penuh pertama dengan kolom harga adalah Mei 2023.
price.effective_price	Angka	Harga yang dikenakan untuk penggunaan.
price.tier_start_amount	Angka	Jumlah unit batas bawah untuk tingkat harga SKU. Misalnya, SKU dengan tiga tingkat harga seperti 0-100 unit, 101-1.000 unit, dan 1.001+ unit, akan menampilkan tiga baris harga untuk SKU tersebut, dengan 0, 101, dan 1001 di kolom price.tier_start_amount yang menunjukkan jumlah unit awal untuk tingkat harga SKU. Pelajari lebih lanjut tingkat harga Google Cloud.
price.unit	String	Unit penggunaan yang digunakan untuk menetapkan harga dan mengukur penggunaan resource (seperti gibibyte, tebibyte, bulan, tahun, jam gibibyte, bulan gibibyte, atau jumlah). Nilai di kolom price.unit cocok dengan nilai di kolom usage.pricing_unit.
price.pricing_unit_quantity	Angka	Jumlah unit tingkat harga SKU. Misalnya, jika harga tingkatnya adalah $1 per 1000000 Byte, kolom ini akan menampilkan 1000000.
transaction_type	String	Jenis transaksi penjual. Jenis transaksi dapat berupa salah satu dari hal berikut: GOOGLE = 1: Layanan yang dijual oleh Google Cloud. THIRD_PARTY_RESELLER = 2: Layanan pihak ketiga yang dijual kembali oleh Google Cloud. THIRD_PARTY_AGENCY = 3: Layanan pihak ketiga yang dijual oleh partner, dengan Google Cloud bertindak sebagai agen. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom ini adalah Agustus 2023.
seller_name	String	Nama resmi penjual. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom ini adalah Agustus 2023.
subscription	Struct	Kolom yang menjelaskan komitmen berbasis pembelanjaan atau resource Anda. Anda dapat menggunakan kolom ini untuk menganalisis biaya pada komitmen tertentu.
subscription.instance_id	String	ID langganan yang terkait dengan komitmen. Catatan: Untuk Google Cloud, bulan penuh pertama data dengan kolom harga adalah Februari 2024.

Catatan tambahan tentang skema

Kolom tidak berlaku untuk Google Workspace

Jika suatu kolom tidak berlaku untuk Kelompok Produk, data yang diekspor untuk kelompok produk ini akan berisi null dalam kolom/kolom ini. Kolom/kolom berikut tidak berlaku untuk ekspor Google Workspace:

• project
• labels
• resource
• credits
• adjustmentsInfo
• cost_at_list
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name

Catatan lain tentang ekspor Google Workspace

Ada beberapa perilaku khusus terkait ekspor Google Workspace:

• Data Google Workspace tidak berisi penggunaan reseller sendiri.
• Jika cost_type adalah tax dan adjustment, usage.amount_in_pricing_units selalu 1.
• Dalam invoice Google Workspace, pajak ditampilkan sebagai satu item baris. Dalam ekspor tersebut, pajak diperinci berdasarkan pelanggan. Meskipun total pajak harus sama dengan invoice, pajak perorangan mungkin memiliki sedikit ketidakakuratan pembulatan.

billing_account_id

• Untuk Google Cloud, ini adalah akun Penagihan Cloud yang terkait dengan penggunaan.
• Untuk Google Workspace, ini adalah ID Cloud Identity pelanggan.

service dan sku

Untuk Google Workspace, kolom ini mewakili "Produk" dan "SKU" yang terkait dengan penggunaan. Pelajari ID Produk & SKU lebih lanjut.

Catatan: Untuk SKU Google Drive lama, sku.description mungkin tidak cocok dengan kolom "Langganan" di CSV invoice (misalnya, CSV menampilkan "Penyimpanan Google Drive 20 GB", tetapi sku.description menampilkan 20 GB). Hal ini sesuai untuk SKU Google Drive lama. Nilai ini dapat ditemukan di Partner Sales Console. Buka Pelanggan tertentu, klik langganan lama, lalu klik "Lihat paket pembayaran". Selanjutnya, Anda akan melihat nilai yang sesuai dengan sku.description.

usage_start_time dan usage_end_time

Dalam CSV invoice Google Workspace, tanggal ini direpresentasikan sebagai tanggal. Dalam hasil ekspor, stempel waktu ini direpresentasikan sebagai stempel waktu:

• Untuk usage_start_time, ini adalah waktu mulai (termasuk) langganan, pukul 00.00 PST pada tanggal mulai.
• Untuk usage_end_time, ini adalah waktu berakhir (eksklusif) langganan, pada pukul 00.00 PST pada sehari setelah tanggal akhir.

project.labels

Untuk Google Cloud, ini adalah key:value pair di project Google Cloud tempat penggunaan terjadi. Untuk informasi selengkapnya, lihat Menggunakan Label.

labels

Untuk Google Cloud, ini adalah key:value pair di resource Google Cloud tempat penggunaan terjadi. Untuk informasi selengkapnya, lihat Menggunakan Label.

system_labels

• Untuk Google Cloud, ini adalah key-value pair di resource Google Cloud tempat penggunaan terjadi. Untuk informasi selengkapnya, lihat Label sistem yang tersedia.

• Untuk Google Workspace, berikut adalah metadata tambahan terkait biaya, yang mencakup:

  • workspace.googleapis.com/domain_name: Nama domain pelanggan.
  • workspace.googleapis.com/order_id: ID pesanan.
  • workspace.googleapis.com/purchase_order_id: ID pesanan pembelian (PO).
  • workspace.googleapis.com/subscription_id: ID langganan.
  • workspace.googleapis.com/usage_type: Jenis penggunaan. Tidak berlaku jika cost_type bukan regular.

Jenis penggunaan Google Workspace mencakup:

• COMMITMENT_TERM_START_ITEM: Awal langganan. Biasanya terkait dengan paruh bulan untuk langganan komitmen yang ditagih bulanan dan untuk periode penagihan/kontrak untuk langganan prabayar.
• COMMITMENT_TERM_END_ITEM: Mengakhiri langganan. Biasanya terkait dengan tagihan bulan terakhir dari langganan komitmen yang ditagih bulanan.
• COMMITMENT_TERM_RENEWAL_ITEM: Awal periode langganan berikutnya.
• COMMITMENT_MONTHLY_ITEM: Penggunaan yang dicatat untuk komitmen yang ada di awal bulan. Biasanya, tagihan akan diperpanjang sepanjang bulan.
• COMMITMENT_SEATS_CHANGE_ITEM: Dicatat saat level komitmen berubah (baik peningkatan atau penurunan). Sering kali dimulai pada pertengahan bulan dan diperpanjang hingga akhir bulan untuk langganan komitmen yang ditagih bulanan atau hingga akhir periode penagihan/kontrak untuk langganan prabayar.
• COMMITMENT_CANCEL_ITEM: Direkam saat langganan dibatalkan. Termasuk tagihan yang terkait dengan penghentian awal. Mewakili biaya untuk sisa periode kontrak saat kontrak dibatalkan di tengah-tengah atau kredit yang dikeluarkan untuk sisa periode penagihan saat kontrak diubah atau dibatalkan di tengah jalan.
• FLEXIBLE_SEATS_ITEM: Merekam penggunaan oleh beberapa pengguna untuk blok yang berdekatan selama beberapa hari. Saat ini hanya ditujukan untuk pengguna tanpa komitmen.
• COUPON_DISCOUNT_ITEM: Jumlah diskon yang terkait dengan kupon.
• MIGRATED_CREDIT_ITEM: Kredit dari migrasi Postini.
• COMMITMENT_PREPAY_BILLING_PERIOD_ITEM: Menampilkan info penggunaan yang dibuat di awal siklus pembayaran untuk seluruh siklus bagi langganan prabayar komitmen.

usage.amount

Untuk penggunaan berbasis slot Google Workspace, hal ini menunjukkan slot berbayar. Misalnya, slot komitmen untuk komitmen atau jumlah slot yang dibayarkan secara fleksibel.

usage.pricing_unit

• Untuk Google Cloud, pelajari lebih lanjut Cloud Billing Catalog API
• Untuk Google Workspace, namanya adalah count.

credits.id

Untuk Google Cloud, ID ini dapat berupa ID unik alfanumerik (12-b34-c56-d78), atau deskripsi jenis kredit (Diskon Abonemen: CPU). Jika kolom credits.id kosong, SKU produk tidak terkait dengan kredit.

credits.full_name

Untuk Google Cloud, ini adalah deskripsi credits.id alfanumerik yang dapat dibaca manusia. Contohnya mencakup Kredit uji coba gratis atau Diskon abonemen berbasis pengeluaran . Nilai credits.full_name hanya diisi untuk SKU dengan credits.id alfanumerik. Jika nilai credits.id adalah deskripsi jenis kredit (seperti Diskon Abonemen: CPU), kolom credits.full_name akan kosong.

credits.type

Untuk Google Cloud, jenis kredit meliputi:

• COMMITTED_USAGE_DISCOUNT: Kontrak abonemen berbasis resource yang dibeli untuk Compute Engine sebagai imbalan atas harga diskon yang sangat besar untuk penggunaan VM.
• COMMITTED_USAGE_DISCOUNT_DOLLAR_BASE : Kontrak abonemen berbasis pembelanjaan yang dibeli untuk layanan dengan imbalan komitmen Anda untuk membelanjakan jumlah minimum.
• DISCOUNT: Jenis kredit diskon digunakan untuk kredit yang diperoleh setelah nilai minimum pembelanjaan kontrak tercapai. Perhatikan bahwa dalam laporan Penagihan Cloud yang tersedia di Partner Sales Console, jenis kredit diskon tercantum sebagai Diskon berbasis pengeluaran (kontraktual).
• FREE_TIER : Beberapa layanan menawarkan penggunaan resource gratis hingga batas yang ditentukan Untuk layanan ini, kredit diterapkan untuk menerapkan penggunaan paket gratis.
• PROMOTION: Jenis kredit promosi mencakup Uji Coba Gratis Google Cloud dan kredit kampanye pemasaran, atau hibah lainnya untuk menggunakan Google Cloud. Jika tersedia, kredit promo dianggap sebagai metode pembayaran dan otomatis diterapkan untuk mengurangi total tagihan Anda.
• RESELLER_MARGIN: Jika Anda adalah reseller, jenis kredit margin reseller menunjukkan Diskon Program Reseller yang diperoleh dari setiap item baris yang memenuhi syarat.
• SUBSCRIPTION_BENEFIT: Kredit yang diperoleh dengan membeli langganan layanan jangka panjang dengan imbalan diskon.
• SUSTAINED_USAGE_DISCOUNT: Jenis kredit diskon untuk penggunaan berkelanjutan adalah diskon otomatis yang Anda peroleh karena menjalankan resource Compute Engine tertentu selama sebagian besar bulan penagihan.

adjustmentsInfo

Untuk Google Cloud, nilai ini hanya diisi jika item baris biaya dibuat untuk modifikasi Penagihan Cloud. Jenis adjustmentsInfo berisi detail tentang penyesuaian, baik yang dikeluarkan untuk memperbaiki error maupun alasan lainnya.

adjustmentsInfo.adjustment_type

Untuk Google Cloud, hal ini mencakup:

• USAGE_CORRECTION: Koreksi karena penggunaan yang dilaporkan salah.
• PRICE_CORRECTION: Koreksi karena aturan penetapan harga yang salah.
• METADATA_CORRECTION: Koreksi untuk memperbaiki metadata tanpa mengubah biaya.
• GOODWILL: Kredit yang diberikan kepada pelanggan untuk membangun reputasi.
• SALES_BASED_GOODWILL: Kredit yang diberikan kepada pelanggan untuk membangun reputasi, sebagai bagian dari kontrak.
• SLA_VIOLATION: Kredit yang diberikan kepada pelanggan karena pelanggaran tujuan tingkat layanan (SLO).
• BALANCE_TRANSFER: Penyesuaian untuk mentransfer dana dari satu akun pembayaran ke akun pembayaran lainnya.
• ACCOUNT_CLOSURE: Penyesuaian untuk mengembalikan akun yang ditutup ke saldo nol.
• GENERAL_ADJUSTMENT: Modifikasi akun penagihan umum.

adjustmentsInfo.adjustment_mode

Untuk Google Cloud, hal ini mencakup:

• PARTIAL_CORRECTION: Koreksi sebagian meniadakan biaya dan penggunaan awal.
• COMPLETE_NEGATION_WITH_REMONETIZATION: Koreksi sepenuhnya meniadakan penggunaan dan biaya asli, serta masalah item baris yang diperbaiki dengan penggunaan dan biaya yang diperbarui.
• COMPLETE_NEGATION: Koreksi sepenuhnya meniadakan penggunaan dan biaya asli, dan tidak ada penggunaan lebih lanjut yang dimonetisasi ulang.
• MANUAL_ADJUSTMENT: Penyesuaian dialokasikan ke biaya dan penggunaan secara manual.

price.effective_price

Untuk Google Cloud, ini adalah harga yang dikenakan untuk penggunaan SKU Google Cloud atau Google Maps Platform dan tingkat harga SKU. Jika akun Penagihan Cloud Anda memiliki harga kontrak kustom, ini adalah harga khusus akun penagihan Anda. Jika tidak, ini adalah harga jual SKU atau tingkat SKU.