קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
שירות הספרייה של Admin SDK מאפשר לכם להשתמש ב-Directory API של Admin SDK ב-Apps Script. ממשק ה-API הזה מאפשר לאדמינים של דומיינים Google Workspace (כולל למפיצים) לנהל מכשירים, קבוצות, משתמשים וישויות אחרות בדומיינים שלהם.
חומרי עזר
מידע מפורט על השירות הזה זמין במסמכי העזרה של Admin SDK Directory API. כמו כל השירותים המתקדמים ב-Apps Script, שירות הספרייה של Admin SDK משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות השיטות.
/** * Lists all the users in a domain sorted by first name. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/list */functionlistAllUsers(){letpageToken;letpage;do{page=AdminDirectory.Users.list({domain:'example.com',orderBy:'givenName',maxResults:100,pageToken:pageToken});constusers=page.users;if(!users){console.log('Nousersfound.');return;}// Print the user's full name and email.for(constuserofusers){console.log('%s(%s)',user.name.fullName,user.primaryEmail);}pageToken=page.nextPageToken;}while(pageToken);}
אחזור משתמש
הדוגמה הזו מקבלת משתמש לפי כתובת האימייל שלו ומתעדת את כל הנתונים שלו כמחרוזת JSON.
/** * Get a user by their email address and logs all of their data as a JSON string. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users/get */functiongetUser(){// TODO (developer) - Replace userEmail value with yoursconstuserEmail='liz@example.com';try{constuser=AdminDirectory.Users.get(userEmail);console.log('Userdata:\n%s',JSON.stringify(user,null,2));}catch(err){// TODO (developer)- Handle exception from the APIconsole.log('Failedwitherror%s',err.message);}}
הוספת משתמש/ת
בדוגמה הזו מתואר הוספה של משתמש חדש לדומיין, כולל רק את המידע הנדרש. הרשימה המלאה של שדות המשתמש מופיעה בחומר העזרה של ה-API.
/** * Adds a new user to the domain, including only the required information. For * the full list of user fields, see the API's reference documentation: * @see https://developers.google.com/admin-sdk/directory/v1/reference/users/insert */functionaddUser(){letuser={// TODO (developer) - Replace primaryEmail value with yoursprimaryEmail:'liz@example.com',name:{givenName:'Elizabeth',familyName:'Smith'},// Generate a random password string.password:Math.random().toString(36)};try{user=AdminDirectory.Users.insert(user);console.log('User%screatedwithID%s.',user.primaryEmail,user.id);}catch(err){// TODO (developer)- Handle exception from the APIconsole.log('Failedwitherror%s',err.message);}}
/** * Creates an alias (nickname) for a user. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/users.aliases/insert */functioncreateAlias(){// TODO (developer) - Replace userEmail value with yoursconstuserEmail='liz@example.com';letalias={alias:'chica@example.com'};try{alias=AdminDirectory.Users.Aliases.insert(alias,userEmail);console.log('Createdalias%sforuser%s.',alias.alias,userEmail);}catch(err){// TODO (developer)- Handle exception from the APIconsole.log('Failedwitherror%s',err.message);}}
/** * Lists all the groups in the domain. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/groups/list */functionlistAllGroups(){letpageToken;letpage;do{page=AdminDirectory.Groups.list({domain:'example.com',maxResults:100,pageToken:pageToken});constgroups=page.groups;if(!groups){console.log('Nogroupsfound.');return;}// Print group name and email.for(constgroupofgroups){console.log('%s(%s)',group.name,group.email);}pageToken=page.nextPageToken;}while(pageToken);}
/** * Adds a user to an existing group in the domain. * @see https://developers.google.com/admin-sdk/directory/reference/rest/v1/members/insert */functionaddGroupMember(){// TODO (developer) - Replace userEmail value with yoursconstuserEmail='liz@example.com';// TODO (developer) - Replace groupEmail value with yoursconstgroupEmail='bookclub@example.com';constmember={email:userEmail,role:'MEMBER'};try{AdminDirectory.Members.insert(member,groupEmail);console.log('User%saddedasamemberofgroup%s.',userEmail,groupEmail);}catch(err){// TODO (developer)- Handle exception from the APIconsole.log('Failedwitherror%s',err.message);}}
[[["התוכן קל להבנה","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"]],["עדכון אחרון: 2024-12-21 (שעון UTC)."],[[["The Admin SDK Directory service enables Google Workspace administrators to manage domain resources like users, groups, and devices within Apps Script using the Directory API."],["This advanced service requires enabling both the Admin SDK and the specific service before use, and it mirrors the functionality of the public Directory API."],["Sample code snippets demonstrate common tasks like listing and managing users, creating aliases, and handling groups and their members via the Admin SDK Directory service."],["Before using the sample code, remember to enable the Admin SDK, replace placeholder values with your specific data, and refer to the documentation for details on API usage and error handling."]]],[]]