الخطوات الأولى
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عندما تعمل مع جهة اتصال المبيعات أو الدعم لإعداد إمكانية الوصول إلى الإصدار 2.0 من "نقل البيانات"
سيتم تزويدك باسم حزمة. عليك تزويد جهة الاتصال المسؤولة عن المبيعات
مجموعة Google التي تمكّنك من التحكم في
الوصول إلى ملفات بياناتك في Google Cloud Storage.
يمكنك اختيار الوصول إلى بياناتك باستخدام أداة مساعدة.
أو يمكنك كتابة الرمز الخاص بك.
الوصول إلى البيانات باستخدام أداة gsutil
أداة gsutil هي تطبيق سطر أوامر، مكتوب في لغة بايثون،
الوصول إلى بياناتك بدون الحاجة إلى استخدام أي ترميز. إِنْتَ
يمكن، على سبيل المثال، استخدام أداة gsutil كجزء من نص برمجي أو ملف دفع بدلاً من
إنشاء تطبيقات مخصصة.
لبدء استخدام gsutil، اقرأ gsutil
ذات الصلة. ستطلب منك الأداة إدخال بيانات اعتمادك لأول مرة
يمكنك استخدامها ثم تخزينها لاستخدامها لاحقًا.
أمثلة على أداة gsutil
يمكنك إدراج جميع ملفاتك باستخدام gsutil على النحو التالي:
gsutil ls gs://[bucket_name]/[object name/file name]
تستخدم أداة gsutil الكثير من بناء الجملة نفسه مثل UNIX، بما في ذلك حرف البدل
علامة النجمة (*)، وبالتالي يمكنك إدراج جميع ملفات ظهور الشبكة:
gsutil ls gs://[bucket_name]/dcm_account6837_impression_*
من السهل أيضًا تنزيل ملف:
gsutil cp gs://[bucket_name]/dcm_account6837_impression_2015120100.log.gz
يمكنك نسخ ملفاتك من حِزم DT Google الموزَّعة إلى حزمة GCS الخاصة بك في Google API.
باستخدام نص هيكل نظام التشغيل Unix، هناك خياران:
الوصول إلى البيانات آليًا
تتضمن خدمة Google Cloud Storage واجهات برمجة تطبيقات ونماذج للعديد من البرامج.
لغات تتيح لك الوصول إلى بياناتك بطريقة آلية. فيما يلي
الخطوات الخاصة بالإصدار 2.0 من "نقل البيانات" التي يجب اتّخاذها لإنشاء
التكامل العملي.
الحصول على حساب خدمة
لبدء استخدام الإصدار 2.0 من "نقل البيانات"، عليك أولاً
استخدام
أداة الإعداد، التي ترشدك خلال إنشاء مشروع في
وحدة التحكم في واجهة Google API، وتفعيل واجهة برمجة التطبيقات، وإنشاء بيانات الاعتماد.
لإعداد حساب خدمة جديد، عليك اتّباع الخطوات التالية:
- انقر على إنشاء بيانات اعتماد > مفتاح حساب الخدمة
- اختَر ما إذا كنت تريد تنزيل المفتاح العام/الخاص لحساب الخدمة كملف
ملف P12 عادي، أو كملف JSON يمكن تحميله من خلال عميل واجهة برمجة تطبيقات Google
المكتبة.
يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، ويعد هذا الزوج هو النسخة الوحيدة من هذا المفتاح. أنت مسؤول عن تخزينه
بأمان.
تأكَّد من إبقاء هذه النافذة مفتوحة، ستحتاج إلى عنوان البريد الإلكتروني لحساب الخدمة.
في الخطوة التالية.
إضافة حساب خدمة إلى مجموعتك
- انتقِل إلى مجموعة Google.
- انقر على "مجموعاتي" واختَر المجموعة التي تستخدمها لإدارة أذونات الوصول.
إلى حزمة DT v2.0 Cloud Storage
- النقر على "إدارة"
- لا تنقر على "دعوة أعضاء".
- النقر على "إضافة أعضاء مباشرةً"
- انسخ البريد الإلكتروني لحساب الخدمة من الخطوة السابقة إلى
صندوق الأعضاء
- اختيار عدم تلقّي رسائل إلكترونية
- انقر على الزر "إضافة".
نقرت بدون قصد على "دعوة أعضاء"
المزيد...
- لا داعي للقلق. يمكنك حلّ هذه المشكلة.
- العودة إلى شاشة "الإدارة" كما في السابق
- انقر على الدعوات البارزة
- ابحث عن حساب الخدمة واختَره.
- انقر على إلغاء الدعوة أعلى الشاشة
- النقر على "إضافة أعضاء مباشرةً" واستئناف الخطوات أعلاه
النطاق
يجب أن تكون أي نطاقات يتم تمريرها إلى Cloud Storage للقراءة فقط
على سبيل المثال، عند استخدام مكتبة برامج Java فإن النطاق الصحيح
المستخدم هي:
StorageScopes.DEVSTORAGE_READ_ONLY
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-31 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-31 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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"]]
