Profile Filter Links: insert

Memerlukan otorisasi

Buat link filter profil baru. Coba sekarang atau lihat contoh.

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/profiles/profileId/profileFilterLinks

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
accountId string ID Akun untuk membuat link filter profil.
profileId string ID profil untuk membuat link filter.
webPropertyId string Nomor properti web untuk membuat link filter profil.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca selengkapnya tentang autentikasi dan otorisasi).

Cakupan
https://www.googleapis.com/auth/analytics.edit

Isi permintaan

Dalam isi permintaan, sediakan resource Link Filter Profil dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti yang Diperlukan
filterRef.id string ID Filter. dapat ditulis
Properti Opsional
rank integer Peringkat link filter profil ini relatif terhadap filter lain yang ditautkan ke profil yang sama.

Untuk operasi hanya baca (yaitu, daftar dan dapatkan), peringkatnya selalu dimulai dari 1.

Untuk operasi tulis (yaitu, buat, update, atau hapus), Anda dapat menentukan nilai antara 0 dan 255 secara inklusif, [0, 255]. Untuk memasukkan link di akhir daftar, jangan menentukan peringkat atau menetapkan peringkat ke angka yang lebih besar dari peringkat terbesar dalam daftar. Untuk menyisipkan link ke awal daftar, tentukan peringkat yang kurang dari atau sama dengan 1. Link baru akan memindahkan semua filter yang ada dengan peringkat yang sama atau lebih rendah ke dalam daftar. Setelah link disisipkan/diupdate/dihapus, semua link filter profil akan diberi nomor ulang mulai dari 1.

 dapat ditulis

Tanggapan

Jika berhasil, metode ini menampilkan resource Link Filter Profil dalam isi respons.

Contoh

Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).

Java

Menggunakan library klien Java.

/*
 * Note: This code assumes you have an authorized Analytics service object.
 * See the Filters Developer Guide for details.
 */

/*
 * This request creates a new profile filter link.
 */

// Construct the filter reference.
FilterRef filterRef = new FilterRef();
filterRef.setId("1223334444");

// Construct the body of the request.
ProfileFilterLink body = new ProfileFilterLink();
body.setFilterRef(filterRef);

try {
analytics.management().profileFilterLinks().insert("123456",
    "UA-123456-1", "7654321", body).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

Python

Menggunakan library klien Python.

# Note: This code assumes you have an authorized Analytics service object.
# See the Filters Developer Guide for details.

# This request creates a new profile filter link.
try:
  analytics.management().profileFilterLinks().insert(
      accountId='123456',
      webPropertyId='UA-123456-1',
      profileId='7654321',
      body={
          'filterRef': {
              'id': '1223334444'
          }
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat responsnya. Atau, coba Penjelajah mandiri.