Node.js

Google menyediakan library klien Node.js untuk berinteraksi dengan Ad Manager API.

Prasyarat

Untuk menggunakan library klien Node.js, Anda harus menginstal Node.js. Untuk mengetahui informasi selengkapnya, lihat Mendownload Node.js®.

Menginstal library klien

Untuk memulai, buat project baru di IDE pilihan Anda atau tambahkan dependensi ke project yang ada. Google memublikasikan artefak library klien ke npm sebagai @google-ads/admanager.

package.json 

"dependencies": {
  "@google-ads/admanager": "^0.4.0"
}

Command line 

npm install @google-ads/admanager

Mengonfigurasi kredensial

Untuk melakukan autentikasi, library klien Node.js menggunakan OAuth2 dan Kredensial Default Aplikasi (ADC). Untuk membuat dan mengonfigurasi kredensial ADC, lihat Autentikasi.

Membuat permintaan pertama Anda

Setiap layanan memiliki objek ServiceClient dengan metode untuk setiap metode REST. Untuk mengetahui contoh setiap metode, lihat repositori GitHub googleapis/google-cloud-node. Contoh berikut membaca objek Network:

// Resource name of the Network
const name = 'networks/NETWORK_CODE'

// Imports the Admanager library
const {NetworkServiceClient} = require('@google-ads/admanager').v1;

// Instantiates a client
const admanagerClient = new NetworkServiceClient();

async function callGetNetwork() {
  // Construct request
  const request = {
    name,
  };

  // Run request
  const response = await admanagerClient.getNetwork(request);
  console.log(response);
}

callGetNetwork();

Mencatat permintaan dan respons HTTP

Library klien Node.js mendukung pencatatan permintaan dan respons HTTP. Secara default, library klien menonaktifkan pencatatan.

Untuk mengaktifkan pencatatan default ke output standar, tetapkan variabel lingkungan GOOGLE_SDK_NODE_LOGGING ke daftar nama paket Google API yang dipisahkan koma. Anda dapat mengaktifkan pencatatan untuk semua Google API dengan menetapkan nilai variabel ke all. Untuk mengetahui semua nama paket library klien yang tersedia, lihat Library Klien Node.js Google Cloud

Node.js 

// Enable logging for the Google Ad Manager API
process.env.GOOGLE_SDK_NODE_LOGGING = 'admanager';

// Enable logging for the Google Ad Manager and pubsub APIs.
process.env.GOOGLE_SDK_NODE_LOGGING = 'admanager,pubsub';

// Enable logging for all Google APIs
process.env.GOOGLE_SDK_NODE_LOGGING = 'all';

Linux atau macOS 

# Enable logging for the Google Ad Manager API.
export GOOGLE_SDK_NODE_LOGGING=admanager

# Enable logging for the Google Ad Manager and pubsub APIs.
export GOOGLE_SDK_NODE_LOGGING=admanager,pubsub

# Enable logging for all Google APIs
export GOOGLE_SDK_NODE_LOGGING=all

Windows 

# Enable logging for the Google Ad Manager API.
set GOOGLE_SDK_NODE_LOGGING=admanager

# Enable logging for the Google Ad Manager and pubsub APIs.
set GOOGLE_SDK_NODE_LOGGING=admanager,pubsub

# Enable logging for all Google APIs
set GOOGLE_SDK_NODE_LOGGING=all

Atau, Anda dapat mengubah backend pencatatan atau mengaitkan peristiwa log. Untuk mengetahui informasi selengkapnya, lihat Alat Pencatatan Google.

Menangani error

Di library klien Node.js, semua error Ad Manager API akan menampilkan pengecualian berjenis type GaxiosError.

Error Ad Manager API mencakup pesan error dan nilai requestId unik yang dapat Anda berikan kepada tim dukungan API. Untuk mendapatkan bantuan terkait pemecahan masalah, lihat Menghubungi dukungan API. Contoh berikut mengekstrak nilai requestId dan pesan error:

const admanagerClient = new NetworkServiceClient();
try {
  const network = admanagerClient.getNetwork(
    { name: 'networks/NETWORK_CODE' }
  );
  console.log(network);
} catch(e) {
  if (e instanceof GaxiosError) {
    // Load the error
    const apiError = JSON.parse(e.message).error;
    const requestInfoType = 'type.googleapis.com/google.rpc.RequestInfo';
    const requestInfo = apiError.details.find(detail => detail['@type'] === requestInfoType);
    console.error(apiError.status + ' - ' + apiError.message);
    console.error('RequestId: ' + requestInfo.requestId);
  } else {
    throw e;
  }
}