شروع شدن
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
وقتی با مخاطب فروش یا پشتیبانی خود برای تنظیم دسترسی به Data Transfer نسخه 2.0 کار می کنید، یک نام سطل به شما ارائه می شود. باید مخاطب فروش خود را یک گروه Google ارائه دهید که به شما امکان می دهد دسترسی به فایل های داده خود را در Google Cloud Storage کنترل کنید.
شما می توانید انتخاب کنید که با استفاده از یک ابزار به داده های خود دسترسی داشته باشید یا می توانید کد خود را بنویسید.
با استفاده از gsutil به داده ها دسترسی پیدا کنید
ابزار gsutil یک برنامه کاربردی خط فرمان است که به زبان پایتون نوشته شده است و به شما امکان می دهد بدون نیاز به کدنویسی به داده های خود دسترسی داشته باشید. برای مثال، می‌توانید از gsutil به‌عنوان بخشی از یک اسکریپت یا فایل دسته‌ای به جای ایجاد برنامه‌های سفارشی استفاده کنید.
برای شروع با gsutil مستندات gsutil را بخوانید. این ابزار در اولین باری که از آن استفاده می‌کنید، اعتبارنامه‌هایتان را از شما می‌خواهد و سپس آن‌ها را برای استفاده در آینده ذخیره می‌کند.
نمونه های gsutil
شما می توانید تمام فایل های خود را با استفاده از gsutil به صورت زیر فهرست کنید:
gsutil ls gs://[bucket_name]/[object name/file name] gsutil از سینتکس مشابه یونیکس، از جمله ستاره عام (*) استفاده می کند، بنابراین می توانید تمام فایل های NetworkImpression را فهرست کنید:
gsutil ls gs://[bucket_name]/dcm_account6837_impression_* همچنین دانلود یک فایل آسان است:
gsutil cp gs://[bucket_name]/dcm_account6837_impression_2015120100.log.gz می‌توانید فایل‌های خود را از سطل‌های پراکنده DT Google در سطل Google API GCS خود با استفاده از اسکریپت پوسته یونیکس کپی کنید، دو گزینه وجود دارد:
دسترسی به داده ها به صورت برنامه ای
Google Cloud Storage دارای API و نمونه‌هایی برای بسیاری از زبان‌های برنامه‌نویسی است که به شما امکان می‌دهد به داده‌های خود به روش برنامه‌نویسی دسترسی داشته باشید. در زیر مراحل ویژه انتقال داده نسخه 2.0 وجود دارد که باید برای ایجاد یک ادغام کاری انجام دهید.
یک حساب کاربری دریافت کنید
برای شروع استفاده از Data Transfer نسخه 2.0، ابتدا باید از ابزار راه اندازی استفاده کنید که شما را از طریق ایجاد پروژه در کنسول API Google، فعال کردن API و ایجاد اعتبارنامه راهنمایی می کند.
برای راه اندازی یک حساب سرویس جدید، موارد زیر را انجام دهید:
- روی ایجاد اعتبارنامه > کلید حساب سرویس کلیک کنید.
- انتخاب کنید که آیا کلید عمومی/خصوصی حساب سرویس به‌عنوان فایل استاندارد P12 بارگیری شود یا به‌عنوان فایل JSON که می‌تواند توسط کتابخانه سرویس گیرنده Google API بارگیری شود.
جفت کلید عمومی/خصوصی جدید شما تولید و در دستگاه شما دانلود می شود. به عنوان تنها کپی این کلید عمل می کند. شما مسئول نگهداری ایمن آن هستید.
حتما این پنجره را باز نگه دارید، در مرحله بعد به ایمیل اکانت سرویس نیاز خواهید داشت.
یک حساب سرویس به گروه خود اضافه کنید
- به Google Group بروید
- روی My Groups کلیک کنید و گروهی را که برای مدیریت دسترسی به سطل فضای ذخیره سازی ابری DT v2.0 استفاده می کنید انتخاب کنید.
- روی Manage کلیک کنید
- روی دعوت از اعضا کلیک نکنید!
- روی Direct add اعضا کلیک کنید
- ایمیل حساب سرویس را از مرحله قبل در کادر اعضا کپی کنید
- بدون ایمیل را انتخاب کنید
- روی دکمه Add کلیک کنید
من تصادفاً روی دعوت از اعضا کلیک کردم
بیشتر...- وحشت نکنید! میتونی درستش کنی
- مانند قبل به صفحه مدیریت بازگردید
- روی دعوتنامه های برجسته کلیک کنید
- حساب سرویس را پیدا کنید و آن را انتخاب کنید
- روی Revoke invitation در بالای صفحه کلیک کنید
- روی Direct add اعضا و ادامه مراحل بالا کلیک کنید
دامنه
هر محدوده‌ای که به فضای ذخیره‌سازی ابری منتقل می‌شود باید فقط خواندنی باشد
به عنوان مثال، هنگام استفاده از کتابخانه سرویس گیرنده جاوا، محدوده صحیح استفاده به صورت زیر است:
StorageScopes.DEVSTORAGE_READ_ONLY
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eData Transfer v2.0 provides access to your data files stored in a designated Google Cloud Storage bucket.\u003c/p\u003e\n"],["\u003cp\u003eYou can control access to your data by providing a Google Group to your sales contact during setup.\u003c/p\u003e\n"],["\u003cp\u003eTwo primary methods for accessing your data are available: using the gsutil command-line utility or programmatically via Google Cloud Storage APIs.\u003c/p\u003e\n"],["\u003cp\u003eProgrammatic access requires setting up a service account and granting it read-only access to your data within the designated Google Group.\u003c/p\u003e\n"]]],["Data Transfer v2.0 access requires a bucket name and a Google Group for control. Access data via the `gsutil` command-line tool, using commands like `gsutil ls` (list files) and `gsutil cp` (copy files), or programmatically using Google Cloud Storage APIs. For programmatic access, create a service account, download its key, and add it to your Google Group for bucket access. Ensure the service account's scope is set to \"read-only,\" for example: `StorageScopes.DEVSTORAGE_READ_ONLY`. You can copy files between buckets using scripts.\n"],null,["# Getting Started\n\nWhen you work with your sales or support contact to setup access to Data Transfer v2.0,\nyou will be provided with a bucket name. You will need to provide your sales contact a\n[Google Group](http://groups.google.com/) which enables you to control\naccess to your data files in [Google Cloud Storage](//cloud.google.com/storage/).\n\n\nYou can choose to access your data using a [utility](#access-data-using-gsutil)\nor you can write your own [code.](#access-data-programmatically)\n\nAccess data using gsutil\n------------------------\n\nThe gsutil tool is a command-line application, written in Python, that\nlets you access your data without having to do any coding. You\ncould, for example, use gsutil as part of a script or batch file instead of\ncreating custom applications.\n\n\nTo get started with gsutil read the [gsutil\ndocumentation](/storage/docs/gsutil). The tool will prompt you for your credentials the first time\nyou use it and then store them for use later on.\n\n### gsutil examples\n\nYou can list all of your files using gsutil as follows:\n`gsutil ls gs://[bucket_name]/[object name/file name]`\n\ngsutil uses much of the same syntax as UNIX, including the wildcard\nasterisk (\\*), so you can list all NetworkImpression files:\n`gsutil ls gs://[bucket_name]/dcm_account6837_impression_*`\n\nIt's also easy to download a file:\n`gsutil cp gs://[bucket_name]/dcm_account6837_impression_2015120100.log.gz`\n\nYou can copy your files from the dispersed DT Google buckets to your own Google API GCS Bucket\nusing a Unix shell script, there are two options:\n\n- In gsutil, if you are using a Unix System, run the following for all your buckets daily:\n\n ```bash\n $ day=$(date --date=\"1 days ago\" +\"%m-%d-%Y\")\n $ gsutil -m cp gs://{\u003cdcmhashid_A\u003e,\u003cdcmhashid_B\u003e,etc.}/*$day*.log.gz gs://\u003cclient_bucket\u003e/\n ```\n- Alternatively, a solution that is a little trickier is to use a bash file:\n\n ```bash\n #!/bin/bash\n\n set -x\n\n buckets={dfa_-hasid_A dfa_-hashid_B,...} #include all hash ids\n day=$(date --date=\"1 days ago\" +\"%m-%d-%Y\")\n for b in ${buckets[@]}; do /\n gsutil -m cp gs://$b/*$day*.log.gz gs:/// /\n done\n ```\n\nAccess data programmatically\n----------------------------\n\n\n[Google Cloud Storage](/storage) has APIs and [samples](/storage/docs/json_api/v1/libraries) for many programming\nlanguages that allow you to access your data in a programmatic way. Below are\nthe steps specific to Data Transfer v2.0 that you must take to build a\nworking integration.\n\n### Get a service account\n\n\nTo get started using Data Transfer v2.0, you need to first\n[use\nthe setup tool](https://console.cloud.google.com/start/api?id=storage_component&credential=client_key), which guides you through creating a project in the\nGoogle API Console, enabling the API, and creating credentials.\n\n\u003cbr /\u003e\n\n\nTo set up a new service account, do the following:\n\n1. Click **Create credentials \\\u003e Service account key**.\n2. Choose whether to download the service account's public/private key as a standard P12 file, or as a JSON file that can be loaded by a Google API client library.\n\nYour new public/private key pair is generated and downloaded to your machine;\nit serves as the only copy of this key. You are responsible for storing it\nsecurely.\n\n\u003cbr /\u003e\n\n|\n| **Note:** If you plan to access Google Cloud Storage using the\n| [JSON API](/storage/docs/json_api), then you must also verify\n| that the [Google Cloud Storage JSON API](//console.developers.google.com//project/_/apiui/apiview/storage_api/overview) component is activated as well.\n\nBe sure to keep this window open, you will need the service account email\nin the next step.\n\n\n### Add a service account to your group\n\n- Go to [Google Group](http://groups.google.com/)\n- Click on My Groups and select the group you use for managing access to your DT v2.0 Cloud Storage Bucket\n- Click Manage\n- **Do not click Invite Members!**\n- Click Direct add members\n- Copy the service account email from the previous step into the members box\n- Select No email\n- Click the Add button\n\n#### I accidentally clicked Invite Members\n\n[More...]()\n\n- Don't Panic! You can fix it\n- Head back to the Manage screen as before\n- Click on Outstanding Invitations\n- Find the service account and select it\n- Click Revoke invitation at the top of the screen\n- Click Direct add members and resume steps above\n\n### Scope\n\n\n**Any scopes passed to Cloud Storage must be Read Only**\n\nFor example, when using the Java client library the correct scope to\nuse is: \n\n```scdoc\nStorageScopes.DEVSTORAGE_READ_ONLY\n```\n\n\u003cbr /\u003e"]]
