Mengekspor data Layanan Saluran ke BigQuery

Halaman ini menunjukkan cara mengonfigurasi ekspor Layanan Channel, 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 biaya, kredit, dan data 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 mengetahui 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 untuk project tersebut.
• Aktifkan BigQuery Data Transfer Service API di project.
• Buat set data untuk data yang diekspor.

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

Untuk mengetahui informasi mendetail 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 Anda 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 Google Cloud peran administrator Reseller.

  Pelajari cara menetapkan Google Cloud peran 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 di project tersebut.

Pilih project dan set data

Di Konsol Penjualan Partner, pilih project dan set data di BigQuery untuk menyimpan data Layanan Saluran. Aktifkan penagihan di project jika belum diaktifkan.

Saat memilih atau membuat set data BigQuery, Anda dapat memilih salah satu lokasi BigQuery yang didukung untuk set data. Saat 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 ekspor BigQuery tersedia untuk setiap sumber data yang dipilih sejak awal bulan sebelumnya. Misalnya, jika Anda mengaktifkan BigQuery Export pada 23 September, ekspor Anda akan menyertakan data mulai 1 Agustus.

• Jika Anda mengonfigurasi set data BigQuery untuk menggunakan lokasi region (selain multi-region AS atau Uni Eropa), data ekspor BigQuery Anda 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.

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

1. Di set data BigQuery yang ingin Anda gunakan untuk mengekspor data, pastikan Administrator Penagihan untuk setiap akun Partner Sales Console memiliki izin untuk melihat set data tersebut.
2. Saat menyiapkan ekspor data penagihan di setiap akun Partner Sales Console, pilih set data gabungan.

Lokasi BigQuery yang didukung

Ada dua jenis region yang didukung BigQuery.

Multi-region

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

Region

Tabel berikut mencantumkan region di Amerika tempat ekspor data BigQuery Layanan Channel didukung.

Tabel berikut mencantumkan region di Asia Pasifik tempat ekspor data BigQuery Channel Services didukung.

Tabel berikut mencantumkan region di Eropa tempat ekspor data BigQuery Channel Services didukung.

Aktifkan ekspor

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

Untuk mengaktifkan ekspor Layanan Saluran:

1. Di Partner Sales Console, buka halaman Penagihan.
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 Perbarui.

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

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

Data biaya penagihan ulang mungkin tidak tersedia selama durasi penonaktifannya. Jika Anda menghapus data 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 layanan adalah:

cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com

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

Membuat kueri data secara efisien

Tabel BigQuery dipartisi menurut export_time dan dikelompokkan menurut payer_billing_account_id secara default. Artinya, tabel dibagi menjadi partisi yang lebih kecil, yang masing-masing dibagi lagi menjadi 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 ini efisien dibandingkan dengan kueri tanpa kunci partisi dan 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 mengetahui informasi selengkapnya tentang partisi, pengelompokan, dan praktik terbaik, lihat link berikut:

1. Mengkueri tabel Berpartisi
2. Membuat kueri 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 Partner Sales Console dan klik tab Penagihan partner.

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

Menyiapkan kontrol akses untuk pengguna lain pada set data ekspor

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

Untuk memastikan bahwa pengguna hanya memiliki akses ke data yang berwenang mereka lihat, sebaiknya siapkan Tabel virtual yang diotorisasi untuk membagikan data dari set data yang diekspor.

Untuk ekspor data berkelanjutan, saat Anda menyiapkan izin untuk pengguna, pastikan akun layanan cloud-channel-billing-reporting-rebilling@system.gserviceaccount.com selalu memiliki akses editor penuh pada set data ekspor.

Skema tabel

Skema berikut menjelaskan data dalam tabel BigQuery.

Dalam set data BigQuery Anda, detail ekspor penagihan ulang dimuat ke dalam tabel data bernama reseller_billing_detailed_export_v1.

Catatan tambahan tentang skema

Ada beberapa catatan tambahan tentang skema.

Kolom yang tidak berlaku untuk Google Workspace

Jika kolom atau bidang tidak berlaku untuk Kategori Produk, data yang diekspor untuk kategori produk ini berisi null di bidang ini. Kolom berikut tidak berlaku untuk ekspor Google Workspace:

• project
• labels
• resource
• credits
• adjustmentsInfo
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Kolom yang tidak berlaku untuk SKU Consumptive Google Workspace

Jika kolom atau bidang tidak berlaku untuk Kategori Produk, data yang diekspor untuk kategori produk ini berisi null di bidang ini. Kolom berikut tidak berlaku untuk ekspor Google Workspace:

• service.id
• sku.id
• project
• labels
• resource
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• transaction_type
• seller_name
• subscription

Kolom yang tidak berlaku untuk pesanan offline (pratinjau)

Jika kolom atau kolom tidak berlaku untuk Rangkaian Produk, data yang diekspor untuk rangkaian produk ini berisi null di kolom atau kolom ini. Kolom atau kolom berikut tidak berlaku untuk ekspor penagihan pesanan offline:

• project
• labels
• system_labels
• location
• resource
• credits
• entitlement_name
• channel_partner_name
• channel_partner_cost
• customer_name
• customer_cost
• cost_at_list
• customer_repricing_config_name
• channel_partner_repricing_config_name
• tags
• price.effective_price
• price.tier_start_amount
• price.list_price
• price.effective_price_default
• price.list_price_consumption_model
• transaction_type
• seller_name
• consumption_model

Catatan lain tentang ekspor Google Workspace

Ada beberapa perilaku khusus dengan ekspor Google Workspace:

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

billing_account_id

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

service dan sku

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

Untuk SKU konsumtif Google Workspace (Google Voice dan Drive), kolom sku.id dan service.id berisi null.

usage_start_time dan usage_end_time

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

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

project.labels

Untuk Google Cloud, ini adalah pasangan nilai kunci pada Google Cloud project tempat penggunaan terjadi. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Label .

labels

Untuk Google Cloud, ini adalah pasangan nilai kunci pada resource Google Cloud tempat penggunaan terjadi. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Label .

system_labels

• Untuk Google Cloud, ini adalah pasangan nilai kunci pada resourceGoogle Cloud tempat penggunaan terjadi. Untuk mengetahui informasi selengkapnya, lihat Label sistem yang tersedia.

• Untuk Google Workspace, ini 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 meliputi:

• COMMITMENT_TERM_START_ITEM: Awal langganan. Biasanya terkait dengan sebagian bulan untuk langganan komitmen yang ditagih bulanan dan untuk periode penagihan atau kontrak untuk langganan prabayar.
• COMMITMENT_TERM_END_ITEM: Akhir langganan. Biasanya terkait dengan tagihan bulan lalu untuk langganan komitmen yang ditagih bulanan.
• COMMITMENT_TERM_RENEWAL_ITEM: Awal periode langganan lanjutan.
• COMMITMENT_MONTHLY_ITEM: Penggunaan yang dicatat untuk komitmen yang ada di awal bulan. Dalam sebagian besar kasus, tagihan akan diperpanjang sepanjang bulan.
• COMMITMENT_SEATS_CHANGE_ITEM: Dicatat saat tingkat komitmen berubah (baik naik maupun turun). Sering kali dimulai di pertengahan bulan dan berlanjut hingga akhir bulan untuk langganan komitmen yang ditagih bulanan atau hingga akhir periode penagihan atau kontrak untuk langganan prabayar.
• COMMITMENT_CANCEL_ITEM: Direkam saat langganan dibatalkan. Mencakup biaya yang terkait dengan penghentian lebih awal. Mewakili tagihan untuk sisa periode kontrak jika kontrak dibatalkan di tengah periode atau kredit yang diberikan untuk sisa periode penagihan jika kontrak diubah atau dibatalkan di tengah periode.
• FLEXIBLE_SEATS_ITEM: Mencatat penggunaan oleh sejumlah pengguna untuk blok berdekatan selama beberapa hari. 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: Merepresentasikan info penggunaan yang dibuat di awal siklus pembayaran untuk seluruh siklus langganan prabayar komitmen.

usage.amount

Untuk penggunaan berbasis slot Google Workspace, slot berbayar akan ditampilkan. Misalnya, slot yang terpakai untuk komitmen atau jumlah slot fleksibel yang dibeli.

Untuk SKU konsumtif Google Workspace (Google Voice dan Drive), ini adalah jumlah menit yang digunakan.

usage.pricing_unit

• Untuk Google Cloud, pelajari lebih lanjut Cloud Billing Catalog API {: track-type="tasks" class="external" track-name="externalLink" track-metadata-position="body"}
• Untuk Google Workspace, ini adalah count.

credits.id

Untuk Google Cloud, 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 yang dapat dibaca manusia dari credits.id alfanumerik. 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 mencakup:

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

adjustmentsInfo

Untuk Google Cloud, nilai ini hanya diisi jika item baris biaya dibuat untuk perubahan Penagihan Cloud. Jenis adjustmentsInfo berisi detail penyesuaian, baik yang dikeluarkan untuk mengoreksi 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 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 memindahkan akun yang ditutup ke saldo nol.
• GENERAL_ADJUSTMENT: Perubahan akun Penagihan Cloud umum.

adjustmentsInfo.adjustment_mode

Untuk Google Cloud, hal ini mencakup:

• PARTIAL_CORRECTION: Koreksi sebagian mengabaikan penggunaan dan biaya 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, harga ini khusus untuk Penagihan Cloud Anda. Jika tidak, ini adalah harga jual SKU atau tingkat SKU.