نیاز به مجوز دارد
پیوند موجود webProperty-Google Ads را به روز می کند. این روش از معنای پچ پشتیبانی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حسابی که ویژگی وب داده شده به آن تعلق دارد. |
webPropertyAdWordsLinkId | string | دارایی وب - شناسه پیوند Google Ads. |
webPropertyId | string | شناسه دارایی وب برای بازیابی پیوند Google Ads برای. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.edit |
درخواست بدن
در بدنه درخواست، بخشهای مربوطه از یک منبع Google Ads Links را مطابق با قوانین معنایی پچ، با ویژگیهای زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
ویژگی های اختیاری | |||
adWordsAccounts[] | list | فهرستی از حسابهای مشتری Google Ads. اینها نمی توانند حساب های MCC باشند. این فیلد هنگام ایجاد پیوند Google Ads الزامی است. نمی تواند خالی باشد. | قابل نوشتن |
name | string | نام لینک. این فیلد هنگام ایجاد پیوند Google Ads الزامی است. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع Google Ads Links را در بدنه پاسخ باز می گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: this code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /* * This request patches an existing Google Ads Link. */ // Construct a list of AdWordsAccounts. AdWordsAccount adWordsAccount = new AdWordsAccount(); adWordsAccount.setCustomerId("123-456-7890"); List<AdWordsAccount> adWordsAccounts = Arrays.asList(adWordsAccount); // Construct the body of the request. EntityAdWordsLink adWordsLink = new EntityAdWordsLink(); adWordsLink.setAdWordsAccounts(adWordsAccounts); adWordsLink.setName("Google Ads Link"); try{ analytics.management().webPropertyAdWordsLinks().patch("123456", "UA-123456-1", "AABBCCDDEEFFGG", adWordsLink).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
از کتابخانه مشتری PHP استفاده می کند.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /** * This request patches an existing Google Ads Link. */ // Construct an Google Ads account object. $adWordsAccount = new Google_Service_Analytics_AdWordsAccount(); $adWordsAccount->setCustomerId("123-456-7890"); // Construct the body of the request. $adWordsLink = new Google_Service_Analytics_EntityAdWordsLink(); $adWordsLink->setName('Google Ads Link'); $adWordsLink->setAdWordsAccounts(array($adWordsAccount)); try { $analytics->management_webPropertyAdWordsLinks->patch('123456', 'UA-123456-1', 'AABBCCDDEEFFGG', $adWordsLink); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# Note: This code assumes you have an authorized Analytics service object. # See the Google Ads Links Developer Guide for details. # This request patches an existing Google Ads Link. try: analytics.management().webPropertyAdWordsLinks().patch( accountId='123456', webPropertyId='UA-123456-1', webPropertyAdWordsLinkId='AABBCCDDEEFFGG', body={ 'adWordsAccounts': [ { 'customerId': '123-456-7890' } ], 'name': 'Google Ads Link' } ).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))
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Google Ads Links Developer Guide for details. */ /* * This request patches an existing Google Ads Link. */ function patchAdWordsLink() { var request = gapi.client.analytics.management.webPropertyAdWordsLinks.patch( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'webPropertyAdWordsLinks': '11112222233334444', 'resource': { 'adWordsAccounts': [ { 'customerId': '123-456-7890'} ], 'name': 'Patched Google Ads Link' } }); request.execute(function (response) { // Handle the response. }); }
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.
نیاز به مجوز دارد
پیوند موجود webProperty-Google Ads را به روز می کند. این روش از معنای پچ پشتیبانی می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
PATCH https://www.googleapis.com/analytics/v3/management/accounts/accountId/webproperties/webPropertyId/entityAdWordsLinks/webPropertyAdWordsLinkId
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حسابی که ویژگی وب داده شده به آن تعلق دارد. |
webPropertyAdWordsLinkId | string | دارایی وب - شناسه پیوند Google Ads. |
webPropertyId | string | شناسه دارایی وب برای بازیابی پیوند Google Ads برای. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/analytics.edit |
درخواست بدن
در بدنه درخواست، بخشهای مربوطه از یک منبع Google Ads Links را مطابق با قوانین معنایی پچ، با ویژگیهای زیر ارائه کنید:
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
ویژگی های اختیاری | |||
adWordsAccounts[] | list | فهرستی از حسابهای مشتری Google Ads. اینها نمی توانند حساب های MCC باشند. این فیلد هنگام ایجاد پیوند Google Ads الزامی است. نمی تواند خالی باشد. | قابل نوشتن |
name | string | نام لینک. این فیلد هنگام ایجاد پیوند Google Ads الزامی است. | قابل نوشتن |
واکنش
در صورت موفقیت آمیز بودن، این روش یک منبع Google Ads Links را در بدنه پاسخ باز می گرداند.
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: this code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /* * This request patches an existing Google Ads Link. */ // Construct a list of AdWordsAccounts. AdWordsAccount adWordsAccount = new AdWordsAccount(); adWordsAccount.setCustomerId("123-456-7890"); List<AdWordsAccount> adWordsAccounts = Arrays.asList(adWordsAccount); // Construct the body of the request. EntityAdWordsLink adWordsLink = new EntityAdWordsLink(); adWordsLink.setAdWordsAccounts(adWordsAccounts); adWordsLink.setName("Google Ads Link"); try{ analytics.management().webPropertyAdWordsLinks().patch("123456", "UA-123456-1", "AABBCCDDEEFFGG", adWordsLink).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); }
PHP
از کتابخانه مشتری PHP استفاده می کند.
/** * Note: This code assumes you have an authorized Analytics service object. * See the Google Ads Links Developer Guide for details. */ /** * This request patches an existing Google Ads Link. */ // Construct an Google Ads account object. $adWordsAccount = new Google_Service_Analytics_AdWordsAccount(); $adWordsAccount->setCustomerId("123-456-7890"); // Construct the body of the request. $adWordsLink = new Google_Service_Analytics_EntityAdWordsLink(); $adWordsLink->setName('Google Ads Link'); $adWordsLink->setAdWordsAccounts(array($adWordsAccount)); try { $analytics->management_webPropertyAdWordsLinks->patch('123456', 'UA-123456-1', 'AABBCCDDEEFFGG', $adWordsLink); } catch (apiServiceException $e) { print 'There was an Analytics API service error ' . $e->getCode() . ':' . $e->getMessage(); } catch (apiException $e) { print 'There was a general API error ' . $e->getCode() . ':' . $e->getMessage(); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# Note: This code assumes you have an authorized Analytics service object. # See the Google Ads Links Developer Guide for details. # This request patches an existing Google Ads Link. try: analytics.management().webPropertyAdWordsLinks().patch( accountId='123456', webPropertyId='UA-123456-1', webPropertyAdWordsLinkId='AABBCCDDEEFFGG', body={ 'adWordsAccounts': [ { 'customerId': '123-456-7890' } ], 'name': 'Google Ads Link' } ).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))
جاوا اسکریپت
از کتابخانه سرویس گیرنده جاوا اسکریپت استفاده می کند.
/* * Note: This code assumes you have an authorized Analytics client object. * See the Google Ads Links Developer Guide for details. */ /* * This request patches an existing Google Ads Link. */ function patchAdWordsLink() { var request = gapi.client.analytics.management.webPropertyAdWordsLinks.patch( { 'accountId': '123456', 'webPropertyId': 'UA-123456-1', 'webPropertyAdWordsLinks': '11112222233334444', 'resource': { 'adWordsAccounts': [ { 'customerId': '123-456-7890'} ], 'name': 'Patched Google Ads Link' } }); request.execute(function (response) { // Handle the response. }); }
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید. از طرف دیگر، اکسپلورر مستقل را امتحان کنید.