معرفی
createAccountTree
بخشی از Provisioning API است که می تواند برای ایجاد حساب های جدید Google Analytics در مقیاس استفاده شود. برخلاف createAccountTicket
، createAccountTree
به هیچ گونه تعامل کاربر نهایی برای ایجاد کامل حساب نیاز ندارد. فرآیند کاملاً خودکار است. این زمانی مفید است که شما نیاز به ارائه یک حساب Analytics دارید که از طرف مشتری کنترل میکنید و در آن یک نمای سفارشی از آن دادهها را به مشتری خود ارائه میدهید.
این API برای شرکای رزرو شده است که وبسایتها یا ویژگیهای وب کاربران خود را کنترل میکنند. اگر کاربران شما وبسایتها یا ویژگیهای وب خود را کنترل میکنند، در عوض باید حسابهای Analytics کنترل شده توسط کاربر ایجاد کنید .
قبل از اینکه شروع کنی
همه APIهای Google Analytics به روشی مشابه قابل دسترسی هستند. قبل از شروع با Provisioning API باید:
- صفحه کتابخانه های سرویس گیرنده را برای لیست کاملی از کتابخانه های مشتری خاص زبان برنامه نویسی که با API کار می کنند، بخوانید.
- راهنمای مرجع را بخوانید تا در مورد رابط API و نحوه دسترسی به دادهها بدون کتابخانه مشتری بیاموزید.
هر کتابخانه مشتری یک شیء سرویس تجزیه و تحلیل واحد را برای دسترسی به API فراهم می کند. برای ایجاد شیء سرویس معمولاً باید مراحل زیر را طی کنید:
- برنامه خود را در Google API Console ثبت کنید.
- مجوز ایجاد یک حساب Google Analytics جدید.
- یک شیء سرویس Analytics ایجاد کنید.
اگر این مراحل را کامل نکردهاید، لطفاً توقف کرده و آموزش API Hello Google Analytics را بخوانید. این آموزش شما را در مراحل اولیه ساخت اپلیکیشن Google Analytics API راهنمایی می کند. پس از تکمیل، نحوه دسترسی به APIهای Google Analytics برای انجام وظایف دنیای واقعی را خواهید فهمید.
حساب الگو
به عنوان بخشی از مجوز برای استفاده از این API، باید یک حساب Google Analytics جدید ارائه دهید، که به عنوان حساب الگو برای این API عمل می کند. وقتی حسابهای جدید ایجاد میشوند، تنظیمات مختلفی را از حساب الگو به ارث میبرند، از جمله پذیرنده شرایط خدمات، سازمان و تنظیمات مختلف اشتراکگذاری داده . برای جزئیات بیشتر در مورد حساب الگو، از جمله فهرستی از تمام داده های به ارث رسیده، به مرجع createAccountTree
مراجعه کنید.
تهیه یک حساب کاربری
برای ارائه یک حساب Google Analytics جدید، یک درخواست به نقطه پایانی createAccountTree
API ارسال کنید. شما به جزئیات تامین زیر نیاز دارید:
- فیلدهای حساب
-
accountName
برای حساب.
-
- فیلدهای دارایی وب
- یک
webpropertyName
برای ملک. -
websiteUrl
این باید URL مرتبط با ویژگی کاربر برای این حساب Analytics باشد.
- یک
- مشاهده فیلدها
- یک
profileName
برای نمای. -
timezone
برای مشاهده
- یک
پس از دریافت جزئیات، یک تماس تأیید شده با نقطه پایانی API برقرار کنید:
POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
"accountName": "Analytics Account",
"webpropertyName": "Default Property",
"profileName": "Default View",
"timezone": "America/Los_Angeles",
"websiteUrl": "www.example-pet-store.com",
}
در صورت موفقیت آمیز بودن، API با جزئیات حساب جدید ایجاد شده، ویژگی وب و نمای پاسخ می دهد:
{
"account": {
"id": "999999999",
"name": "Analytics Account",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"webproperty": {
"id": "UA-999999999-1",
"name": "Default Property",
"websiteUrl": "www.example-pet-store.com",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"profile": {
"id": "999999999",
"name": "Default View",
"timezone": "America/Los_Angeles",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
...
}
مالکیت و مدیریت حساب
حساب Google Analytics ایجاد شده متعلق به هر حساب کاربری خواهد بود که پاسخ را از طریق OAuth مجاز کرده باشد. به همین دلیل، توصیه می کنیم که سازمان شما به جای یک حساب کاربری فردی، از یک حساب سرویس برای مدیریت حساب Analytics استفاده کند.
پس از ایجاد حساب، می توانید آن را با مدیریت API پیکربندی کنید. در اینجا چند کار رایج برای یک حساب کاربری جدید ایجاد شده است:
- یک حساب Google Ads را پیوند دهید
- اضافه کردن یا مدیریت حساب های کاربری
- نماها، بخشها، اهداف و غیره را اضافه کنید
شفاف سازی روابط حساب
مانند همه APIهای Google، یک پروژه Google Cloud به عنوان نقطه شروع برای مجوز درخواست مورد نیاز است. همانطور که در مستندات OAuth 2.0 توضیح داده شده است، این حساب جایی است که شما اعتبارنامه های خود را برای درخواست های API مدیریت خواهید کرد. با این حال، حساب Google Analytics ایجاد شده به هیچ وجه مستقیماً به پروژه Cloud یا حساب های مدیریتی آن وابسته نیست. این فقط به حساب کاربری یا سرویسی وابسته است که درخواست را مجاز کرده است. اگر نیاز به پیکربندی دسترسی حساب به حساب Analytics دارید، میتوانید از مدیریت API استفاده کنید.
منابع مرتبط
،معرفی
createAccountTree
بخشی از Provisioning API است که می تواند برای ایجاد حساب های جدید Google Analytics در مقیاس استفاده شود. برخلاف createAccountTicket
، createAccountTree
به هیچ گونه تعامل کاربر نهایی برای ایجاد کامل حساب نیاز ندارد. فرآیند کاملاً خودکار است. این زمانی مفید است که شما نیاز به ارائه یک حساب Analytics دارید که از طرف مشتری کنترل میکنید و در آن یک نمای سفارشی از آن دادهها را به مشتری خود ارائه میدهید.
این API برای شرکای رزرو شده است که وبسایتها یا ویژگیهای وب کاربران خود را کنترل میکنند. اگر کاربران شما وبسایتها یا ویژگیهای وب خود را کنترل میکنند، در عوض باید حسابهای Analytics کنترل شده توسط کاربر ایجاد کنید .
قبل از اینکه شروع کنی
همه APIهای Google Analytics به روشی مشابه قابل دسترسی هستند. قبل از شروع با Provisioning API باید:
- صفحه کتابخانه های سرویس گیرنده را برای لیست کاملی از کتابخانه های مشتری خاص زبان برنامه نویسی که با API کار می کنند، بخوانید.
- راهنمای مرجع را بخوانید تا در مورد رابط API و نحوه دسترسی به دادهها بدون کتابخانه مشتری بیاموزید.
هر کتابخانه مشتری یک شیء سرویس تجزیه و تحلیل واحد را برای دسترسی به API فراهم می کند. برای ایجاد شیء سرویس معمولاً باید مراحل زیر را طی کنید:
- برنامه خود را در Google API Console ثبت کنید.
- مجوز ایجاد یک حساب Google Analytics جدید.
- یک شیء سرویس Analytics ایجاد کنید.
اگر این مراحل را کامل نکردهاید، لطفاً توقف کرده و آموزش API Hello Google Analytics را بخوانید. این آموزش شما را در مراحل اولیه ساخت اپلیکیشن Google Analytics API راهنمایی می کند. پس از تکمیل، نحوه دسترسی به APIهای Google Analytics برای انجام وظایف دنیای واقعی را خواهید فهمید.
حساب الگو
به عنوان بخشی از مجوز برای استفاده از این API، باید یک حساب Google Analytics جدید ارائه دهید، که به عنوان حساب الگو برای این API عمل می کند. وقتی حسابهای جدید ایجاد میشوند، تنظیمات مختلفی را از حساب الگو به ارث میبرند، از جمله پذیرنده شرایط خدمات، سازمان و تنظیمات مختلف اشتراکگذاری داده . برای جزئیات بیشتر در مورد حساب الگو، از جمله فهرستی از تمام داده های به ارث رسیده، به مرجع createAccountTree
مراجعه کنید.
تهیه یک حساب کاربری
برای ارائه یک حساب Google Analytics جدید، یک درخواست به نقطه پایانی createAccountTree
API ارسال کنید. شما به جزئیات تامین زیر نیاز دارید:
- فیلدهای حساب
-
accountName
برای حساب.
-
- فیلدهای دارایی وب
- یک
webpropertyName
برای ملک. -
websiteUrl
این باید URL مرتبط با ویژگی کاربر برای این حساب Analytics باشد.
- یک
- مشاهده فیلدها
- یک
profileName
برای نمای. -
timezone
برای مشاهده
- یک
پس از دریافت جزئیات، یک تماس تأیید شده با نقطه پایانی API برقرار کنید:
POST https://www.googleapis.com/analytics/v3/provisioning/createAccountTree
{
"accountName": "Analytics Account",
"webpropertyName": "Default Property",
"profileName": "Default View",
"timezone": "America/Los_Angeles",
"websiteUrl": "www.example-pet-store.com",
}
در صورت موفقیت آمیز بودن، API با جزئیات حساب جدید ایجاد شده، ویژگی وب و نمای پاسخ می دهد:
{
"account": {
"id": "999999999",
"name": "Analytics Account",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"webproperty": {
"id": "UA-999999999-1",
"name": "Default Property",
"websiteUrl": "www.example-pet-store.com",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
"profile": {
"id": "999999999",
"name": "Default View",
"timezone": "America/Los_Angeles",
"created": "2018-03-16T23:35:20.699Z",
"updated": "2018-03-16T23:35:20.699Z",
...
},
...
}
مالکیت و مدیریت حساب
حساب Google Analytics ایجاد شده متعلق به هر حساب کاربری خواهد بود که پاسخ را از طریق OAuth مجاز کرده باشد. به همین دلیل، توصیه می کنیم که سازمان شما به جای یک حساب کاربری فردی، از یک حساب سرویس برای مدیریت حساب Analytics استفاده کند.
پس از ایجاد حساب، می توانید آن را با مدیریت API پیکربندی کنید. در اینجا چند کار رایج برای یک حساب کاربری جدید ایجاد شده است:
- یک حساب Google Ads را پیوند دهید
- اضافه کردن یا مدیریت حساب های کاربری
- نماها، بخشها، اهداف و غیره را اضافه کنید
شفاف سازی روابط حساب
مانند همه APIهای Google، یک پروژه Google Cloud به عنوان نقطه شروع برای مجوز درخواست مورد نیاز است. همانطور که در مستندات OAuth 2.0 توضیح داده شده است، این حساب جایی است که شما اعتبارنامه های خود را برای درخواست های API مدیریت خواهید کرد. با این حال، حساب Google Analytics ایجاد شده به هیچ وجه مستقیماً به پروژه Cloud یا حساب های مدیریتی آن وابسته نیست. این فقط به حساب کاربری یا سرویسی وابسته است که درخواست را مجاز کرده است. اگر نیاز به پیکربندی دسترسی حساب به حساب Analytics دارید، میتوانید از مدیریت API استفاده کنید.