Η διαχείριση της πρόσβασης σε κάδους αποθηκευτικού χώρου της Μεταφοράς δεδομένων γίνεται μέσω ρόλων χρήστη στο Google Ad Manager. Μόλις αποκτήσετε την απαραίτητη άδεια ρόλου χρήστη, μπορείτε να χρησιμοποιήσετε τη μέθοδο της επιλογής σας, για να αποκτήσετε πρόσβαση στα αρχεία της Μεταφοράς δεδομένων.
Μετάβαση σε μια ενότητα του άρθρου:
- Πληροφορίες σχετικά με τους ρόλους χρήστη για την άδεια
- Προβολή της άδειας σε έναν ρόλο
- Μέθοδοι για την πρόσβαση σε κάδους αποθηκευτικού χώρου
- Χρήση του Google Cloud Storage API
Πληροφορίες σχετικά με τους ρόλους χρήστη για την άδεια
Για να αποκτήσετε πρόσβαση στους κάδους αποθηκευτικού χώρου, πρέπει να έχετε έναν ρόλο με ενεργοποιημένη την άδεια Προβολή κάδων μεταφοράς δεδομένων.
- Ρόλοι χρήστη διαχειριστή: Η άδεια είναι ενεργοποιημένη από προεπιλογή για τον ενσωματωμένο ρόλο χρήστη Διαχειριστής.
- Προσαρμοσμένοι ρόλοι χρήστη: Η άδεια μπορεί να προστεθεί σε προσαρμοσμένους ρόλους χρήστη.
Για να κάνετε αλλαγές στους ρόλους χρήστη, πρέπει να είστε διαχειριστής στο δίκτυό σας ή να έχετε την άδεια Επεξεργασία χρηστών, ρόλων και ομάδων στην καρτέλα Διαχειριστής. Λάβετε υπόψη ότι ένας χρήστης μπορεί να συσχετιστεί μόνο με έναν ρόλο τη φορά.
Για περισσότερες λεπτομέρειες, ανατρέξτε στην ενότητα Διαχείριση συνδρομής για ρόλο χρήστη.
Προβολή της άδειας σε έναν ρόλο
Μπορείτε να ελέγξετε τον ρόλο που έχει λάβει ένας χρήστης και να προσθέσετε ή να καταργήσετε την άδεια, όπως απαιτείται.
- Συνδεθείτε στο Google Ad Manager.
- Κάντε κλικ στην επιλογή Διαχειριστής και, στη συνέχεια, επιλέξτε Πρόσβαση και εξουσιοδότηση.
- Κάντε κλικ στην επιλογή Ρόλοι και, στη συνέχεια, στο όνομα ενός ρόλου.
- Στην ενότητα Αναφορές, εντοπίστε την άδεια Προβολή κάδων μεταφοράς δεδομένων.
- (Προαιρετικά) Για να ενεργοποιήσετε την άδεια για τον ρόλο, επιλέξτε το πλαίσιο.
Μέθοδοι για την πρόσβαση σε κάδους αποθηκευτικού χώρου
Το Google Cloud Storage είναι ένα ξεχωριστό προϊόν της Google που χρησιμοποιεί το Ad Manager ως χώρο φύλαξης δεδομένων για τις αναφορές της Μεταφοράς δεδομένων και τα αναγνωριστικά cookie κοινού μαζικής μεταφόρτωσης.
Υπάρχουν τρεις τρόποι με τους οποίους μπορείτε να αποκτήσετε πρόσβαση σε κάδους αποθηκευτικού χώρου του Ad Manager. Κατά σειρά πολυπλοκότητας:
- Στον ιστό: Επισκεφτείτε τη διεύθυνση
https://console.developers.google.com/storage/gdfp-[κωδικός δικτύου Ad Manager]. - Το gsutil είναι ένα εργαλείο γραμμής εντολών που βασίζεται σε Python, το οποίο παρέχει εντολές τύπου Unix για την αλληλεπίδραση με τον κάδο του αποθηκευτικού χώρου. Ο έλεγχος ταυτότητας για τον κάδο αφαιρείται και ο χειρισμός του γίνεται αυτόματα.
- Το API Google Cloud Storage είναι ένα API πλήρους λειτουργικότητας για τη διαχείριση του κάδου του αποθηκευτικού χώρου, το οποίο είναι διαθέσιμο μέσω διεπαφών ιστού JSON ή XML RESTful. Οι βιβλιοθήκες εφαρμογών πελατών API διατίθενται για πολλά δημοφιλή περιβάλλοντα προγραμματισμού, συμπεριλαμβανομένων των Java, JavaScript, Python και Objective-C. Αυτή η προσέγγιση είναι η πιο χρήσιμη, αν χρειάζεται να διαχειριστείτε τους κάδους του αποθηκευτικού χώρου μέσω προγραμματισμού για την ενσωμάτωση με την εφαρμογή Google App Engine ή μια εφαρμογή ιστού Java.
Αυτό το άρθρο παρέχει λεπτομέρειες σχετικά με το API του Google Cloud Storage. Η διαχείριση της πρόσβασης στον ιστό και το gsutil είναι πιο εύκολη, επομένως συνιστούμε να εξερευνήσετε πρώτα αυτές τις μεθόδους. Η πλήρης τεκμηρίωση είναι διαθέσιμη στον ιστότοπο προγραμματιστών του Google Cloud Storage.
Χρήση του Google Cloud Storage API
Εάν έχετε διαπιστώσει ότι η πρόσβαση API καλύπτει καλύτερα τις ανάγκες σας, σάς συνιστούμε να διαμορφώσετε έναν λογαριασμό υπηρεσίας Google Cloud Storage.
Διαμορφώστε έναν λογαριασμό υπηρεσίας του Google Cloud Storage
Κατά την πρόσβαση στον κάδο αποθηκευτικού χώρου μέσω του API, είναι προτιμότερο να διαμορφώσετε έναν λογαριασμό υπηρεσίας αντί για την εκτέλεση στο πλαίσιο ενός χρήστη. Οι λογαριασμοί υπηρεσίας απλοποιούν την ανάπτυξη εφαρμογών χρησιμοποιώντας ένα ιδιωτικό κλειδί για τον έλεγχο ταυτότητας αντί για ένα διακριτικό OAuth που δημιουργείται δυναμικά. Για να διαμορφώσετε έναν λογαριασμό υπηρεσίας:
-
Μεταβείτε στο Google Developer Console.
-
Δημιουργήστε ένα νέο έργο (ή επιλέξτε ένα υπάρχον έργο) ως γονικό στοιχείο της εφαρμογής σας και κάντε κλικ σε αυτό.
-
(Προαιρετικό) Εάν σκοπεύετε να αντιγράψετε αρχεία από τον κάδο αποθηκευτικού χώρου του Ad Manager στον δικό σας λογαριασμό Google Cloud Storage, κάντε κλικ στην επιλογή Χρέωση και ρυθμίσεις για να προσθέσετε μια πηγή χρέωσης στο έργο σας.
-
Δημιουργήστε νέο αναγνωριστικό πελάτη:
-
Κάντε κλικ στην επιλογή API και υπηρεσίες και, στη συνέχεια, στην επιλογή Διαπιστευτήρια.
-
Κάντε κλικ στη Δημιουργία νέου αναγνωριστικού πελάτη.
-
Επιλέξτε Λογαριασμός υπηρεσίας ως τύπο εφαρμογής και, στη συνέχεια, κάντε κλικ στη Δημιουργία αναγνωριστικού πελάτη.
-
Η διεύθυνση ηλεκτρονικού ταχυδρομείου που δημιουργείται λαμβάνει τη μορφή
[unique-id]@developer.gserviceagccount.com. Προσθέστε τον χρήστη λογαριασμού υπηρεσίας στο Ad Manager network και βεβαιωθείτε ότι έχει έναν ρόλο με την άδεια Προβολή κάδων μεταφοράς δεδομένων. -
Κάντε κλικ στη Δημιουργία νέου κλειδιού P12. Το αρχείο αποθηκεύεται στον υπολογιστή σας. Χρησιμοποιήστε αυτό το κλειδί στις εφαρμογές που αναπτύσσετε για να αποκτήσετε πρόσβαση στο API, όπως φαίνεται στο παρακάτω παράδειγμα κώδικα.
-
- Οι χρήστες με την άδεια Προβολή κάδων μεταφοράς δεδομένων θα έχουν πρόσβαση στους κάδους αποθηκευτικού χώρου του Ad Manager.
Η Google παρέχει δείγματα κώδικα και βιβλιοθήκες για το Google Cloud Storage. Το παρακάτω παράδειγμα Java για την ανάγνωση ενός αρχείου από έναν κάδο αποθηκευτικού χώρου cloud του Ad Manager δείχνει τον τρόπο με τον οποίο τα στοιχεία που έχετε διαμορφώσει κατά τη ρύθμιση του λογαριασμού υπηρεσίας ενδέχεται να επηρεάζουν τον κώδικα σας:
-
Όνομα έργου: Το όνομα έργου του Google Cloud Storage.
-
Διεύθυνση ηλεκτρονικού ταχυδρομείου λογαριασμού υπηρεσίας: Η διεύθυνση ηλεκτρονικού ταχυδρομείου που δημιουργήσατε
-
Αρχείο κλειδιού .p12: Το αρχείο που κατεβάσατε.
-
Όνομα κάδου: Η Google παρέχει αυτό το όνομα κατά την ενεργοποίηση μιας λειτουργίας που χρησιμοποιεί κάδους αποθηκευτικού χώρου cloud του Ad Manager.
import java.io.File;
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.OutputStream;
import java.security.GeneralSecurityException;
import java.util.Collections;
import com.google.api.client.googleapis.auth.oauth2.GoogleCredential;
import com.google.api.client.googleapis.javanet.GoogleNetHttpTransport;
import com.google.api.client.http.HttpTransport;
import com.google.api.client.json.jackson2.JacksonFactory;
import com.google.api.services.storage.Storage;
import com.google.api.services.storage.model.StorageObject;
public class GcsApiTest {
/**
* Το όνομα του έργου στο οποίο δημιουργήθηκε ο λογαριασμός υπηρεσίας.
*
* Αυτές οι πληροφορίες εμφανίζονται στο Google Developers Console.
*/
private static final String PROJECT_NAME = "project name";
/**
* Διεύθυνση ηλεκτρονικού ταχυδρομείου του λογαριασμού υπηρεσίας.
*
* Αυτή η διεύθυνση ηλεκτρονικού ταχυδρομείου δημιουργείται κατά τη δημιουργία ενός αναγνωριστικού πελάτη λογαριασμού υπηρεσίας στο
* Google Developers Console και μπορεί να ανακτηθεί από τη σελίδα
* Διαπιστευτηρίων.
*/
private static final String SERVICE_ACCOUNT_EMAIL = "service account email address";
/**
* Κάδος που χρησιμοποιείται για τις λειτουργίες του αποθηκευτικού χώρου.
*
* Το όνομα αυτού του κάδου παρασχέθηκε σε εσάς από τον Υπεύθυνο
* λογαριασμού. Ενδέχεται να έχει ένα όνομα παρόμοιο με "gdfp-12345678" ή
* "gdfp_cookieupload_12345678", ανάλογα με το πρόσθετο Ad Manager που χρησιμοποιείτε.
*/
private static final String BUCKET_NAME = "bucket name";
/**
* Εύρος OAuth 2.0 Google Cloud Storage για ανάγνωση/εγγραφή. Αυτό θα πρέπει να
* αντιστοιχεί στα δικαιώματα πρόσβασης για την άδεια Προβολή κάδων μεταφοράς δεδομένων"
* για τον κάδο και δεν μπορείτε να ζητήσετε δικαιώματα πρόσβασης που
* δεν έχουν παραχωρηθεί μέσω της άδειας.
*/
private static final String STORAGE_SCOPE =
"https://www.googleapis.com/auth/devstorage.read_write";
/**
* Διαδρομή στο αρχείο key.p12 που παρέχει πρόσβαση στον κάδο.
*
* Αυτό το αρχείο δημιουργείται κατά τη δημιουργία του αναγνωριστικού πελάτη υπηρεσίας. Εάν δεν
* έχετε αυτό το αρχείο, θα πρέπει να δημιουργήσετε ένα νέο κλειδί πελάτη p12 από το
* Google Developers Console.
*/
private static final String KEY_P12 = "path to .p12 key file";
/** HTTP transport. */
private HttpTransport httpTransport;
private Storage storage;
// constructor, sets up credentials and storage objects
public GcsApiTest() {
File p12File = new File(KEY_P12);
try {
httpTransport = GoogleNetHttpTransport.newTrustedTransport();
GoogleCredential credential = new GoogleCredential.Builder()
.setTransport(httpTransport)
.setJsonFactory(JacksonFactory.getDefaultInstance())
.setServiceAccountId(SERVICE_ACCOUNT_EMAIL)
.setServiceAccountScopes(
Collections.singleton(STORAGE_SCOPE))
.setServiceAccountPrivateKeyFromP12File(p12File).build();
storage = new Storage.Builder(httpTransport,
JacksonFactory.getDefaultInstance(), credential)
.setApplicationName(PROJECT_NAME).build();
} catch (GeneralSecurityException | IOException e1) {
e1.printStackTrace();
System.exit(1);
}
}
/**
* Η μέθοδος επιστροφής ονόματος του πρώτου αρχείου στον κάδο.
*
* @return the name of the file, or null if the bucket is empty
* @throws IOException
*/
public String GetFirstFile() throws IOException {
Storage.Objects.List listObjects = storage.objects().list(BUCKET_NAME);
listObjects.setMaxResults(5L);
com.google.api.services.storage.model.Objects objects = listObjects
.execute();
// empty bucket?
if (null == objects.getItems() || objects.getItems().isEmpty()) {
System.out.println("Bucket \"" + BUCKET_NAME
+ "\" empty or invalid.");
return null;
}
StorageObject object = objects.getItems().get(0);
System.out.println("First object in bucket: \"" + object.getName()
+ "\".");
return object.getName();
}
/**
* Method to download the specified file from the storage bucket
*
* @param filename
* Το όνομα του αρχείου που πρέπει να ληφθεί.
* @throws IOException
*/
public void DownloadFile(String filename) throws IOException {
Storage.Objects.Get getObject = storage.objects().get(BUCKET_NAME,
filename);
OutputStream os = new FileOutputStream(filename, true);
getObject.getMediaHttpDownloader().setDirectDownloadEnabled(true);
getObject.executeMediaAndDownloadTo(os);
System.out.println("File \"" + filename + "\" downloaded.");
}
/**
* Η κύρια μέθοδος εκτέλεσης των διαφορετικών δοκιμών.
*
* @param args
*/
public static void main(String[] args) {
GcsApiTest gcsApiTest = new GcsApiTest();
try {
String filename = gcsApiTest.GetFirstFile();
gcsApiTest.DownloadFile(filename);
} catch (IOException e) {
System.out.println(e.getMessage());
}
}
}
Περιορισμός και ταυτόχρονες συνδέσεις
Δεν υπάρχει προκαθορισμένο όριο στις ταυτόχρονες συνδέσεις. Ωστόσο, για να αποφευχθεί η κατάχρηση, η Google περιορίζει τα αιτήματα ανάκτησης της Μεταφοράς δεδομένων.