Method: properties.audienceExports.query

صادرات مخاطب از کاربران را بازیابی می کند. پس از ایجاد مخاطب، کاربران بلافاصله برای صادرات در دسترس نیستند. ابتدا درخواست audienceExports.create برای ایجاد صادرات مخاطب از کاربران ضروری است و سپس از این روش برای بازیابی کاربران در صادرات مخاطب استفاده می شود.

برای آشنایی با صادرات مخاطب با مثال به ایجاد صادرات مخاطب مراجعه کنید.

مخاطبان در Google Analytics 4 به شما این امکان را می دهند که کاربران خود را به روش هایی که برای کسب و کار شما مهم هستند تقسیم بندی کنید. برای کسب اطلاعات بیشتر، به https://support.google.com/analytics/answer/9267572 مراجعه کنید.

Audience Export API ها دارای روش هایی در حالت آلفا و روش های دیگر در ثبات بتا هستند. هدف این است که پس از بازخورد و پذیرش، روش‌هایی را برای ثبات بتا پیش ببریم. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.

درخواست HTTP

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

مورد نیاز. نام صادرات مخاطب برای بازیابی کاربران از. قالب: properties/{property}/audienceExports/{audienceExport}

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "offset": string,
  "limit": string
}
فیلدها
offset

string ( int64 format)

اختیاری. تعداد ردیف ردیف شروع. ردیف اول به عنوان ردیف 0 محاسبه می شود.

هنگام صفحه بندی، اولین درخواست افست را مشخص نمی کند. یا به طور معادل، افست را روی 0 تنظیم می کند. اولین درخواست اولین limit ردیف ها را برمی گرداند. درخواست دوم افست را تا limit درخواست اول تنظیم می کند. درخواست دوم limit دوم ردیف ها را برمی گرداند.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

limit

string ( int64 format)

اختیاری. تعداد ردیف هایی که باید برگردانده شوند. اگر مشخص نشده باشد، 10000 ردیف برگردانده می شود. API حداکثر 250000 سطر را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. limit باید مثبت باشد

API همچنین می‌تواند ردیف‌های کمتری را نسبت به limit درخواستی برگرداند، اگر مقادیر ابعاد به اندازه limit وجود نداشته باشد.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

بدن پاسخگو

فهرستی از کاربران در صادرات مخاطب.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
فیلدها
audience Rows[]

object ( AudienceRow )

ردیف‌هایی برای هر کاربر در صادرات مخاطب. تعداد ردیف‌های این پاسخ کمتر یا مساوی اندازه صفحه درخواست خواهد بود.

audience Export

object ( AudienceExport )

داده‌های پیکربندی درباره AudienceExport در حال پرسش است. برای کمک به تفسیر ردیف‌های مخاطب در این پاسخ، بازگشت. برای مثال، ابعاد در این AudienceExport با ستون‌های AudienceRows مطابقت دارد.

row Count

integer

تعداد کل ردیف ها در نتیجه AudienceExport. rowCount مستقل از تعداد سطرهای برگردانده شده در پاسخ، پارامتر درخواست limit و پارامتر درخواست offset است. به عنوان مثال اگر یک پرس و جو 175 ردیف را برمی گرداند و شامل limit 50 در درخواست API می شود، پاسخ شامل rowCount 175 اما فقط 50 ردیف خواهد بود.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

ویژگی های مقدار ابعاد برای ردیف کاربر مخاطب.

نمایندگی JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
فیلدها
dimension Values[]

object ( AudienceDimensionValue )

هر ویژگی ارزش بعد برای یک کاربر مخاطب. برای هر ستون بعد درخواستی یک مقدار بعد اضافه می شود.

AudienceDimensionValue

ارزش یک بعد

نمایندگی JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
فیلدها
فیلد اتحادیه one_value . یک نوع ارزش ابعادی. one_value تنها می تواند یکی از موارد زیر باشد:
value

string

اگر نوع بعد یک رشته است، مقدار را به عنوان یک رشته تعیین کنید.

،

صادرات مخاطب از کاربران را بازیابی می کند. پس از ایجاد مخاطب، کاربران بلافاصله برای صادرات در دسترس نیستند. ابتدا درخواست audienceExports.create برای ایجاد صادرات مخاطب از کاربران ضروری است و سپس از این روش برای بازیابی کاربران در صادرات مخاطب استفاده می شود.

برای آشنایی با صادرات مخاطب با مثال به ایجاد صادرات مخاطب مراجعه کنید.

مخاطبان در Google Analytics 4 به شما این امکان را می دهند که کاربران خود را به روش هایی که برای کسب و کار شما مهم هستند تقسیم بندی کنید. برای کسب اطلاعات بیشتر، به https://support.google.com/analytics/answer/9267572 مراجعه کنید.

Audience Export API ها دارای روش هایی در حالت آلفا و روش های دیگر در ثبات بتا هستند. هدف این است که پس از بازخورد و پذیرش، روش‌هایی را برای ثبات بتا پیش ببریم. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.

درخواست HTTP

POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

پارامترها
name

string

مورد نیاز. نام صادرات مخاطب برای بازیابی کاربران از. قالب: properties/{property}/audienceExports/{audienceExport}

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "offset": string,
  "limit": string
}
فیلدها
offset

string ( int64 format)

اختیاری. تعداد ردیف ردیف شروع. ردیف اول به عنوان ردیف 0 محاسبه می شود.

هنگام صفحه بندی، اولین درخواست افست را مشخص نمی کند. یا به طور معادل، افست را روی 0 تنظیم می کند. اولین درخواست اولین limit ردیف ها را برمی گرداند. درخواست دوم افست را تا limit درخواست اول تنظیم می کند. درخواست دوم limit دوم ردیف ها را برمی گرداند.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

limit

string ( int64 format)

اختیاری. تعداد ردیف هایی که باید برگردانده شوند. اگر مشخص نشده باشد، 10000 ردیف برگردانده می شود. API حداکثر 250000 سطر را در هر درخواست برمی گرداند، مهم نیست که چقدر درخواست کنید. limit باید مثبت باشد

API همچنین می‌تواند ردیف‌های کمتری را نسبت به limit درخواستی برگرداند، اگر مقادیر ابعاد به اندازه limit وجود نداشته باشد.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

بدن پاسخگو

فهرستی از کاربران در صادرات مخاطب.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
فیلدها
audience Rows[]

object ( AudienceRow )

ردیف‌هایی برای هر کاربر در صادرات مخاطب. تعداد ردیف‌های این پاسخ کمتر یا مساوی اندازه صفحه درخواست خواهد بود.

audience Export

object ( AudienceExport )

داده‌های پیکربندی درباره AudienceExport در حال پرسش است. برای کمک به تفسیر ردیف‌های مخاطب در این پاسخ، بازگشت. برای مثال، ابعاد در این AudienceExport با ستون‌های AudienceRows مطابقت دارد.

row Count

integer

تعداد کل ردیف ها در نتیجه AudienceExport. rowCount مستقل از تعداد سطرهای برگردانده شده در پاسخ، پارامتر درخواست limit و پارامتر درخواست offset است. به عنوان مثال اگر یک پرس و جو 175 ردیف را برمی گرداند و شامل limit 50 در درخواست API می شود، پاسخ شامل rowCount 175 اما فقط 50 ردیف خواهد بود.

برای اطلاعات بیشتر در مورد این پارامتر صفحه بندی، صفحه بندی را ببینید.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics

AudienceRow

ویژگی های مقدار ابعاد برای ردیف کاربر مخاطب.

نمایندگی JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
فیلدها
dimension Values[]

object ( AudienceDimensionValue )

هر ویژگی ارزش بعد برای یک کاربر مخاطب. برای هر ستون بعد درخواستی یک مقدار بعد اضافه می شود.

AudienceDimensionValue

ارزش یک بعد

نمایندگی JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
فیلدها
فیلد اتحادیه one_value . یک نوع ارزش ابعادی. one_value تنها می تواند یکی از موارد زیر باشد:
value

string

اگر نوع بعد یک رشته است، مقدار را به عنوان یک رشته تعیین کنید.