تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
عندما تعمل مع جهة اتصال المبيعات أو الدعم لإعداد إمكانية الوصول إلى الإصدار 2.0 من "نقل البيانات"
سيتم تزويدك باسم حزمة. عليك تزويد جهة الاتصال المسؤولة عن المبيعات
مجموعة Google التي تمكّنك من التحكم في
الوصول إلى ملفات بياناتك في Google Cloud Storage.
يمكنك اختيار الوصول إلى بياناتك باستخدام أداة
أو يمكنك كتابة الرمز بنفسك.
الوصول إلى البيانات باستخدام أداة gsutil
أداة gsutil هي تطبيق سطر أوامر مكتوب بلغة Python، ويسمح
لك بالوصول إلى بياناتك بدون الحاجة إلى إجراء أي ترميز. إِنْتَ
على سبيل المثال، استخدام أداة gsutil كجزء من نص برمجي أو ملف دفع بدلاً من
إنشاء تطبيقات مخصصة.
للبدء في استخدام gsutil، يُرجى الاطّلاع على مستندات
أداة gsutil. ستطلب منك الأداة إدخال بيانات اعتمادك لأول مرة
يمكنك استخدامها ثم تخزينها لاستخدامها لاحقًا.
أمثلة على أداة gsutil
يمكنك إدراج جميع ملفاتك باستخدام gsutil على النحو التالي:
gsutil ls gs://[bucket_name]/[object name/file name]
يستخدم gsutil الكثير من بنية الجملة نفسها المستخدَمة في نظام التشغيل UNIX، بما في ذلك علامة البدل
النجمة (*)، حتى تتمكّن من إدراج جميع ملفات NetworkImpression:
gsutil ls gs://[bucket_name]/dcm_account6837_impression_*
يمكنك نسخ ملفاتك من حِزم DT Google الموزَّعة إلى حزمة GCS الخاصة بك في Google API.
باستخدام نص هيكل نظام التشغيل Unix، هناك خياران:
في gsutil، إذا كنت تستخدم نظام التشغيل Unix، يمكنك تنفيذ ما يلي لجميع حِزمك يوميًا:
$day=$(date--date="1 days ago"+"%m-%d-%Y")
$gsutil-mcpgs://{<dcmhashid_A>,<dcmhashid_B>,etc.}/*$day*.log.gzgs://<client_bucket>/
بدلاً من ذلك، يمكنك استخدام ملف bash، وهو حلّ أكثر تعقيدًا:
#!/bin/bashset-x
buckets={dfa_-hasid_Adfa_-hashid_B,...}#include all hash idsday=$(date--date="1 days ago"+"%m-%d-%Y")forbin${buckets[@]};do/
gsutil-mcpgs://$b/*$day*.log.gzgs:////
done
الوصول إلى البيانات آليًا
تتضمن خدمة Google Cloud Storage واجهات برمجة تطبيقات ونماذج للعديد من البرامج.
لغات تتيح لك الوصول إلى بياناتك بطريقة آلية. في ما يلي
الخطوات الخاصة بإصدار "نقل البيانات" 2.0 التي يجب اتّخاذها لإنشاء عملية دمج فعالة.
الحصول على حساب خدمة
للبدء في استخدام الإصدار 2.0 من "نقل البيانات"، عليك أولاً
استخدام
أداة الإعداد، التي ترشدك خلال إنشاء مشروع في
وحدة التحكم في واجهة Google API، وتفعيل واجهة برمجة التطبيقات، وإنشاء بيانات الاعتماد.
لإعداد حساب خدمة جديد، عليك اتّباع الخطوات التالية:
انقر على إنشاء بيانات اعتماد > مفتاح حساب الخدمة
اختَر ما إذا كنت تريد تنزيل المفتاح العام/الخاص لحساب الخدمة كملف P12 عادي
أو كملف JSON يمكن تحميله من خلال مكتبة العميل لـ Google API
.
يتم إنشاء زوج المفتاح العام/الخاص وتنزيله على جهازك، ويعد هذا الزوج هو النسخة الوحيدة من هذا المفتاح. أنت مسؤول عن تخزينه
بأمان.
يُرجى إبقاء هذه النافذة مفتوحة، لأنّك ستحتاج إلى عنوان البريد الإلكتروني لحساب الخدمة
في الخطوة التالية.
تاريخ التعديل الأخير: 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 Google Cloud Storage bucket, controlled by a Google Group you specify.\u003c/p\u003e\n"],["\u003cp\u003eYou can access your data using the gsutil command-line utility or programmatically via Google Cloud Storage APIs.\u003c/p\u003e\n"],["\u003cp\u003eTo access data programmatically, you'll need to set up a service account and grant it read-only access to your Google Group and Cloud Storage bucket.\u003c/p\u003e\n"]]],[],null,["# Get 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"]]
