نیاز به مجوز دارد
یک نسخه کانتینر ایجاد می کند. اکنون آن را امتحان کنید یا نمونه ای را ببینید .
درخواست
درخواست HTTP
POST https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/versions
مولفه های
نام پارامتر | ارزش | شرح |
---|---|---|
پارامترهای مسیر | ||
accountId | string | شناسه حساب GTM. |
containerId | string | شناسه کانتینر GTM. |
مجوز
این درخواست به مجوز با محدوده زیر نیاز دارد ( در مورد احراز هویت و مجوز بیشتر بخوانید ).
محدوده |
---|
https://www.googleapis.com/auth/tagmanager.edit.containerversions |
درخواست بدن
در بدنه درخواست، داده ها را با ساختار زیر ارائه دهید:
{ "quickPreview": boolean, "name": string, "notes": string }
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
quickPreview | boolean | ایجاد این نسخه ممکن است برای پیش نمایش سریع باشد و نباید ذخیره شود. | |
name | string | نام نسخه کانتینری که باید ایجاد شود. | |
notes | string | یادداشتهای نسخه کانتینری که باید ایجاد شود. |
واکنش
در صورت موفقیت آمیز بودن، این روش یک بدنه پاسخ با ساختار زیر را برمی گرداند:
{ "containerVersion": accounts.containers.versions Resource, "compilerError": boolean }
نام ملک | ارزش | شرح | یادداشت |
---|---|---|---|
containerVersion | nested object | نسخه کانتینر ایجاد شد. | |
compilerError | boolean | خطاهای کامپایلر یا نه |
مثال ها
توجه: نمونههای کد موجود برای این روش همه زبانهای برنامهنویسی پشتیبانیشده را نشان نمیدهند (برای فهرست زبانهای پشتیبانیشده به صفحه کتابخانههای سرویس گیرنده مراجعه کنید).
جاوا
از کتابخانه سرویس گیرنده جاوا استفاده می کند.
/* * Note: This code assumes you have an authorized tagmanager service object. */ /* * This request creates a new container version. */ // Create the container versions options object. CreateContainerVersionRequestVersionOptions options = new CreateContainerVersionRequestVersionOptions(); options.setName("Container Version"); options.setNotes("Sample Container Version"); options.setQuickPreview(false); try { CreateContainerVersionResponse response = tagmanager.accounts(). containers().versions().create("123456", "54321", options).execute(); } catch (GoogleJsonResponseException e) { System.err.println("There was a service error: " + e.getDetails().getCode() + " : " + e.getDetails().getMessage()); } /* * The results of the create method are stored in the response object. * The following code shows how to access the created id and fingerprint. */ System.out.println("Compiler Error = " + response.getCompilerError()); ContainerVersion version = response.getContainerVersion(); if (version != null) { System.out.println("Container Version Id = " + version.getContainerVersionId()); System.out.println("Container Version Fingerprint = " + version.getFingerprint()); }
پایتون
از کتابخانه کلاینت پایتون استفاده می کند.
# Note: This code assumes you have an authorized tagmanager service object. # This request creates a new container version. try: response = tagmanager.accounts().containers().versions().create( accountId='123456', containerId='54321', body={ 'name': 'Container Version', 'notes': 'Sample Container Version', 'quickPreview': True } ).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)) # The results of the create method are stored in response object. # The following code shows how to access the created id and fingerprint. version = response.get('containerVersion', {}) print 'Container Version Id = %s' % version.get('containerVersionId') print 'Container Version Fingerprint = %s' % version.get('fingerprint')
آن را امتحان کنید!
از APIs Explorer زیر برای فراخوانی این روش در دادههای زنده و دیدن پاسخ استفاده کنید.