Profile Filter Links: insert

Memerlukan otorisasi

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

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 yang akan digunakan untuk membuat link filter profil.
profileId	string	ID Profil untuk membuat link filter.
webPropertyId	string	ID properti web untuk membuat link filter profil.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut (baca lebih lanjut 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), peringkat selalu dimulai dari 1. Untuk operasi tulis (yaitu, membuat, memperbarui, atau menghapus), Anda dapat menentukan nilai antara 0 dan 255 secara inklusif, [0, 255]. Untuk menyisipkan link di akhir daftar, jangan menentukan peringkat atau menetapkan peringkat ke angka yang lebih besar daripada peringkat terbesar dalam daftar. Untuk menyisipkan tautan 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/diperbarui/dihapus, semua link filter profil akan diberi nomor ulang mulai dari 1.	dapat ditulis

Respons

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 Explorer mandiri.