تتيح لك عمليات تدقيق سجلّ طلبات البحث إنشاء تقرير عن جميع المهام التي تمّ تشغيلها باستخدام حسابك على Ads Data Hub. يتيح لك ذلك الإجابة عن أسئلة تتعلّق بالمستخدمين الذين وصلوا إلى بياناتك ووقت وصولهم إليها.
يتمّ كتابة عمليات تدقيق سجلّ طلبات البحث كجداول في BigQuery تحتوي على إدخالات سجلّ لجميع طلبات البحث التي تمّ تنفيذها باستخدام حسابك على Ads Data Hub. لعرض عمليات تدقيق سجلّ طلبات البحث لحسابك، عليك أولاً إنشاء التقرير من خلال واجهة برمجة تطبيقات. يحتوي كل سجل تدقيق على بيانات ليوم واحد. يمكنك إنشاء سجلّ تدقيق لأيّ يوم خلال آخر 30 يومًا.
لا تتوفّر عمليات تدقيق سجلّ طلبات البحث إلا للمستخدمين المتميّزين. مزيد من المعلومات حول الوصول المستنِد إلى الأدوار
تنسيق تدقيق سجلّ الطلبات
تستخدِم كل عملية تدقيق في سجلّ طلبات البحث المخطّط التالي:
| اسم الحقل | الوصف |
|---|---|
| customer_id | الرقم التعريفي لعميل Ads Data Hub |
| ads_customer_id | رقم تعريف الحساب الفرعي، في حال استخدامه (سيكون مطابقًا لرقم تعريف العميل في حال عدم استخدامه) |
| match_table_customer_id | رقم تعريف الحساب الذي يحتوي على جدول المطابقة، في حال استخدامه (سيكون مطابقًا لرقم تعريف العميل في حال عدم استخدامه) |
| user_email | عنوان البريد الإلكتروني للمستخدم الذي أجرى طلب البحث |
| query_start_time | الوقت الذي بدأ فيه تنفيذ طلب البحث |
| query_end_time | وقت انتهاء تشغيل الطلب |
| query_type | التمييز بين طلبات البحث عن التحليل وطلبات البحث عن الجمهور |
| query_resource_id | المعرّف المرتبط بطلب البحث |
| query_text | لغة الاستعلامات البنيوية (SQL) لطلب البحث |
| query_parameters | |
| query_parameters.name | اسم مَعلمة طلب البحث |
| query_parameters.value | القيمة التي تم تمريرها من خلال مَعلمة طلب البحث row_merge_summary |
| row_merge_summary.column_name | اسم العمود |
| row_merge_summary.merge_type | نوع ملخّص دمج الصفوف |
| row_merge_summary.constant_value | قيمة مجموعة الثابت (ستكون فارغة إذا لم يتم استخدام أي ثابت) |
| destination_table | الموقع الجغرافي (في BigQuery) الذي تمّت كتابة طلب البحث فيه |
الوصول إلى عمليات تدقيق سجلّ طلبات البحث
للوصول إلى عمليات تدقيق سجلّ طلبات البحث، عليك استدعاء واجهة برمجة التطبيقات. يمكنك العثور على نموذج رمز لاستدعاء واجهة برمجة التطبيقات أدناه، أو الاطّلاع على المستندات المرجعية وكتابة طلب البحث الخاص بك.
ستتم كتابة نتائج طلب البيانات من واجهة برمجة التطبيقات في مجموعة بيانات BigQuery التي تحدّدها في نص طلب البيانات من واجهة برمجة التطبيقات.
"""This sample shows how to create a query history audit.
For the program to execute successfully, ensure that you run it using Python 3.
"""
from __future__ import print_function
from json import dumps
from google_auth_oauthlib import flow
from googleapiclient.discovery import build
appflow = flow.InstalledAppFlow.from_client_secrets_file(
# Replace client_secrets.json with your own client secret file.
'client_secrets.json',
scopes=['https://www.googleapis.com/auth/adsdatahub'])
appflow.run_local_server()
credentials = appflow.credentials
developer_key = input('Developer key: ').strip()
service = build('adsdatahub', 'v1', credentials=credentials,
developerKey=developer_key)
def pprint(x):
print(dumps(x, sort_keys=True, indent=4))
customer_id = input('Customer ID (e.g. "customers/123"): ').strip()
bq_project = input('Destination BigQuery project ID (e.g. "your-project"): ').strip()
dataset_id = input('Destination BigQuery dataset (e.g. "your-dataset"): ').strip()
start = input('The start date for your query history audit. Formatted as "mm/dd/yyyy": ').strip().split('/')
end = input('The end date for your query history audit. Should be 1 day later than start_date. Formatted as "mm/dd/yyyy": ').strip().split('/')
choice = input("Do you want to enter a timezone? Defaults to UTC otherwise. (y/n) ")
if choice.lower() == 'y':
timezone = input("Timezone (e.g. 'UTC'): ")
else:
timezone = 'UTC'
body = {
'project_id': bq_project,
'dataset': dataset_id,
'start_date': {
'year': start[2],
'day': start[1],
'month': start[0]
},
'end_date': {
'year': end[2],
'day': end[1],
'month': end[0]
},
'time_zone': timezone
}
pprint(service.customers().exportJobHistory(customer=customer_id, body=body).execute())